Mail dispatch

Introduction #

The server sends emails to known users for functions like reset passwords, send user invitations or device logins, and to administrators for example to warn about the expiration of certificates. The SMTP connection and login credentials are configured in the application.yml file:

relution:
  mail:
    username:
    password:
    host: localhost
    port: 25
  smtp:
    ttls: false
    ssl: false
    ehlo: true

The settings shown above are the default values if they are not configured. SMTP connectivity is tested as part of the server health check, which are displayed in the System Portal.

Amazon Simple Email Service (SES) SMTP #

The recommended settings for connecting to Amazon SES looks like:

relution:
  mail:
    username: ABCDEFGHIJKLMNOPQ123
    password: "abcdefghijklmnopqrstuvwxyz/BASE64+1234567890"
    host: email-smtp.eu-central-1.amazonaws.com
    port: 587
  smtp:
    ttls: true
    ssl: true
    ehlo: true

Note that the SMTP parameters username and password are an AWS access key and a secret key of an IAM user with AmazonSesSendingAccess permissions, which must be ses:SendRawEmail permissions. Please make sure that you have specified the correct region as part of host. These settings can be found on the SMTP Settings page of the SES service in the AWS console.

Microsoft Office365 SMTP #

The recommended settings to be able to send mail via Office 365 are these:

Under Settings - Notifications - E-Mail and SMS, in the field E-Mail from should contain the same email address as in the application.yml in the field username. You must make sure that SMTP AUTH is enabled for the corresponding account.

relution:
  mail:
    username: "email@somehwere.com"
    password: "xxx"
    host: smtp.office365.com
    port: 587
  smtp:
    ttls: true
    ssl: false
    ehlo: true