WebHare can send outgoing mail through Amazon AWS SES, and process bounces/complaints through SNS. This guide will use the Amazon 'aws' command line utility, but you can also do the process through the web interface.

SES allows you to set up 'tenants' which allows you to separate reputation issues. This is now the recommend approach. See https://docs.aws.amazon.com/ses/latest/dg/tenants.html for more information.

This guide will direct you to:

Keep in mind that there may be costs associated with the use of email, tenants, notifications and other features. Always consult the AWS documentation about such costs.

Consider setting up billing tags and using these on the resources created below to help track these costs

Setting up a SMTP acount

Configure a SMTP account with AWs in the AWS console. It will provide you with the email/smtp server name, username and password.

In WebHare, set mail settings: SMTP server (eg email-smtp.eu-central-1.amazonaws.com), port (587), username and password.

Setting up notifications

You can automate this process using:

wh get snsendpoint  #to get the URL mentioned above (SNS ENDPOINT below)
aws sns create-topic --name <TOPIC> # which returns the TOPIC-ARN
aws sns subscribe --topic-arn <TOPIC-ARN> --protocol https --notification-endpoint <SNS ENDPOINT>

Create a tenant

Create a configuration set

Create an identity

You can automate creating the identities using

aws ses verify-email-identity --email-address <EMAIL>  # for an email, or 
aws ses verify-domain-identity --domain <DOMAIN>       # for a domain

aws ses get-identity-dkim-attributes --identities <DOMAIN> # for the DKIM settings

Set up WebHare

Testing

Amazon provides simulator email addresses you can use to test your configuration. For example, emailing bounce@simulator.amazonses.com should allow you to see the Bounce status in the managed queue mail details.