Managing AWS SES (Simple Email Service)

From Contensive Wiki
Revision as of 18:14, 28 October 2016 by Admin (Talk | contribs) (How to setup Amazon SES Email Bounce Processing)

Jump to: navigation, search

Terms

Transient Email Failures 
Are emails that cannot be delivered because of non-permanent problems. These may be temporary issues like "out of the office", or problems with a particular email like "cannot accept email from this address".
Permanent Email Failures 
Are emails that cannot be delivered for reasons that will not recover, like "user does not exist"

Roles

Administrator 
A user with the Administrator checkbox set in their user record, under permissions. Administrators can review the email drop list.

How To

How to setup Amazon SES Email Bounce Processing

  1. You must have first configured SES Email
  2. Click on Amazon SNS (Notifications) on the Amazon AWS Dashboard. Create a topic.
  3. Click on Amazon SQS (Message Queues). Add a message queue. Subscribe the queue to the the SNS topic. Get the URL in the details tab and save in the "AWS SQS Bounce Email Queue Endpoint" in the Email Bounce Settings.
  4. Go to Amazon (SES) and assign the sending Domain and/or email addresses to the SNS topic.
  5. Go to Amazon Identity & Access Management and create a new user for the email block process. Under permissions, add a policy for "AmazonSQSFullAccess". Under Security, create an access key. Save the "AWS Access Key Id" and the "AWS Secret Access Key" in the Email Bounce Settings.
  6. in Email Bounce Settings, check the box next to "Allow AWS Email Bounce Processing".
  7. To test the configuration, send to the following AXS SEs email addresses from the system.
    • success@simulator.amazonses.com
    • bounce@simulator.amazonses.com
    • ooto@simulator.amazonses.com
    • complaint@simulator.amazonses.com
    • suppressionlist@simulator.amazonses.com

How to manage transient email failures

In Email Bounce settings, you set how long Transient grace period. After this period of time, transient failures will automatically be converted to permanent failures. You must periodically review the email bounce list for transient failures that should not be converted to permanent. When you identify one that can be recovered, and make the changes to recover it, delete the record of the Email Bounce List.

References

Email Bounce Settings

Under Navigator > Settings > Email Bounce Settings

Allow AWS Email Bounce Processing 
(For Amazon AWS hosted sites only, requires Amazon SES Email) Use Amazon Notifications to automatically block bad email addresses from your database. When enabled, the site will check with Amazon AWS hourly and if bad email addresses where detected, the user's Allow Group Email will be disabled and the email address will be added to the site's blocked list.
AWS Transient Email Grace Period 
The period of time up to 30 days that email addresses with transient issues will be allowed. You must periodically review the transient email issues in the Email Block List. Transient issues older than this period will be blocked from receiving email.
AWS Access Key Id 
The access key associated with the identity you will use to communicate with the AWS Message system to retrieve bounce and complaint notifications. Use the AWS Identity and Access Management to create you credentials.
AWS Secret Access Key 
The secret access key associated with the identity you will use to communicate with the AWS Message system to retrieve bounce and complaint notifications. Use the AWS Identity and Access Management to create you credentials.
AWS SQS Bounce Email Queue Endpoint 
The URL for the AWS Message Queue you configured to store the bounce messages.

Under Navigator > Settings > Preferences > Email Tab

Test Cases

Change History

10/28/2016 - Created