SMTP Fan-out Plugin

With this plugin, you can send an email for every workflow run and attestation.

How to use it

In the following example, we will use the AWS SES service.

1. To get started, you need to register the plugin in your Chainloop organization.

chainloop integration registered add smtp --opt user=AHDHSYEE7e73 --opt password=kjsdfda8asd**** --opt host=email-smtp.us-east-1.amazonaws.com --opt port=587 --opt [email protected] --opt [email protected]

2. When attaching the integration to your workflow, you have the option to specify CC:

chainloop integration attached add --workflow $WID --integration $IID --opt [email protected]

cc is optional:

chainloop workflow integration attach --workflow $WID --integration $IID

Starting now, every time a workflow run occurs, an email notification will be sent containing the details of the run and attestation.

Registration Input Schema

Field	Type	Required	Description
from	string (email)	yes	The email address of the sender.
host	string	yes	The host to use for the SMTP authentication.
password	string	yes	The password to use for the SMTP authentication.
port	string	yes	The port to use for the SMTP authentication
to	string (email)	yes	The email address to send the email to.
user	string	yes	The username to use for the SMTP authentication.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://github.com/chainloop-dev/chainloop/app/controlplane/plugins/core/smtp/v1/registration-request",
  "properties": {
    "to": {
      "type": "string",
      "format": "email",
      "description": "The email address to send the email to."
    },
    "from": {
      "type": "string",
      "format": "email",
      "description": "The email address of the sender."
    },
    "user": {
      "type": "string",
      "minLength": 1,
      "description": "The username to use for the SMTP authentication."
    },
    "password": {
      "type": "string",
      "description": "The password to use for the SMTP authentication."
    },
    "host": {
      "type": "string",
      "description": "The host to use for the SMTP authentication."
    },
    "port": {
      "type": "string",
      "description": "The port to use for the SMTP authentication"
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "to",
    "from",
    "user",
    "password",
    "host",
    "port"
  ]
}

Attachment Input Schema

Field	Type	Required	Description
cc	string (email)	no	The email address of the carbon copy recipient.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://github.com/chainloop-dev/chainloop/app/controlplane/plugins/core/smtp/v1/attachment-request",
  "properties": {
    "cc": {
      "type": "string",
      "format": "email",
      "description": "The email address of the carbon copy recipient."
    }
  },
  "additionalProperties": false,
  "type": "object"
}