Email action

The email action type uses the SMTP protocol to send mail message, using an integration of Nodemailer. Email message text is sent as both plain text and html text.

Connector configuration

Email connectors have the following configuration properties:

Name

The name of the connector. The name is used to identify a connector in the management UI connector listing, or in the connector list when configuring an action.

Sender

The from address for all emails sent with this connector, specified in user@host-name format.

Host

Host name of the service provider. If you are using the xpack.actions.whitelistedHosts setting, make sure this hostname is whitelisted.

Port

The port to connect to on the service provider.

Secure

If true the connection will use TLS when connecting to the service provider. See nodemailer TLS documentation for more information.

Username

username for login type authentication.

Password

password for login type authentication.

Preconfigured action type

  1.  my-email:
  2.    name: preconfigured-email-action-type
  3.    actionTypeId: .email
  4.    config:
  5.      from: testsender@test.com
  6.      host: validhostname
  7.      port: 8080
  8.      secure: false
  9.    secrets:
  10.      user: testuser
  11.      password: passwordkeystorevalue

config defines the action type specific to the configuration and contains the following properties:

from

An email address that corresponds to Sender.

host

A string that corresponds to Host.

port

A number that corresponds to Port.

secure

A boolean that corresponds to Secure.

secrets defines sensitive information for the action type:

user

A string that corresponds to User.

password

A string that corresponds to Password. Should be stored in the Kibana keystore.

Action configuration

Email actions have the following configuration properties:

To, CC, BCC

Each is a list of addresses. Addresses can be specified in user@host-name format, or in name <user@host-name> format. One of To, CC, or BCC must contain an entry.

Subject

The subject line of the email.

Message

The message text of the email. Markdown format is supported.

Configuring email accounts

The email action can send email using many popular SMTP email services.

You configure the email action to send emails using the connector form. For more information about configuring the email connector to work with different email systems, refer to:

Sending email from Gmailedit

Use the following email account settings to send email from the Gmail SMTP service:

  1.   config:
  2.     host: smtp.gmail.com
  3.     port: 465
  4.     secure: true
  5.   secrets:
  6.     user: <username>
  7.     password: <password>

If you get an authentication error that indicates that you need to continue the sign-in process from a web browser when the action attempts to send email, you need to configure Gmail to allow less secure apps to access your account.

If two-step verification is enabled for your account, you must generate and use a unique App Password to send email from Watcher. See Sign in using App Passwords for more information.

Sending email from Outlook.comedit

Use the following email account settings to send email action from the Outlook.com SMTP service:

  1. config:
  2.     host: smtp-mail.outlook.com
  3.     port: 465
  4.     secure: true
  5. secrets:
  6.     user: <email.address>
  7.     password: <password>

When sending emails, you must provide a from address, either as the default in your account configuration or as part of the email action in the watch.

You must use a unique App Password if two-step verification is enabled. See App passwords and two-step verification for more information.

Sending email from Amazon SES (Simple Email Service)edit

Use the following email account settings to send email from the Amazon Simple Email Service (SES) SMTP service:

  1. config:
  2.     host: email-smtp.us-east-1.amazonaws.com 
  3.     port: 465
  4.     secure: true
  5. secrets:
  6.     user: <username>
  7.     password: <password>

smtp.host varies depending on the region

You must use your Amazon SES SMTP credentials to send email through Amazon SES. For more information, see Obtaining Your Amazon SES SMTP Credentials. You might also need to verify your email address or your whole domain at AWS.

Sending email from Microsoft Exchangeedit

Use the following email account settings to send email action from Microsoft Exchange:

  1. config:
  2.     host: <your exchange server>
  3.     port: 465
  4.     secure: true
  5.     from: <email address of service account> 
  6. secrets:
  7.     user: <email address of service account> 
  8.     password: <password>

Some organizations configure Exchange to validate that the from field is a valid local email account.

Many organizations support use of your email address as your username. Check with your system administrator if you receive authentication-related failures.

Most Popular