Managing AWS SES (Simple Email Service)

From Contensive Wiki
Revision as of 20:09, 25 August 2020 by Admin (Talk | contribs) (→‎Email Bounce Settings)

Jump to: navigation, search

This tool is used to capture email bounces and automatically mark them as bad addresses.

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"
Email Bounce List 
A database table found in the Email Bounce Process Collection that includes an entry for every bounce email detected.
AWS SES 
Amazon Web Services - Simple Email Service.
AWS SQS 
Amazon Web Services - Simple Query Service, a persistent messaging tool.
AWS SNS 
Amazon Web Services - Simple notification Service, a push notification tool.
Email Blocked List 
An internal list of email addresses that have permanent bounces or a request to stop emails to the address was sent.

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 Save AWS Settings on the Website

  1. Login and click on ADMIN, SETTINGS EMAIL.
  2. Check the box next to field "Use AWS Simple Email Service (SES).
  3. Enter AWS User Name in field "AWS Access Key ID".
  4. Enter AWS Password in field "AWS Secret Access Key".

How to Approve a FROM address on Amazon AWS SES

Send an email to support@contensive.com that contains each email address or the whole domain.

How to Manage Bounce Processing on the Website

  1. Periodically review the list at Manage Add-ons, Amazon SES Email, Email Bounce List.
  2. If in the Details the bounce is marked as Transient, after you make any necessary changes to recover it, you can delete this record from the list to enable emails to this email address.
  3. If in the Details the bounce is marked as Permanent, the email address will be added to the Email Blocked Report. See Blocked Emails

How to Manage Blocked Emails on the Website

  1. To view the Email Blocked Report, click Reports, Email Blocked Report.
  2. To have an email removed from this list, please contact support@contensive.com to provide the list of emails you would like removed from the blocked list.

References

Email Bounce Settings

Under Admin > Settings > Email Bounce Settings

Description

Email Bounce Processing Description
  • We create an SNS Topic (ses-bounces-topic) for SES bounces/complaints
  • We create an SQS Queue (ses-bounces-queue) and subscribe it to the topic.
  • We assign the topic to the verified from-address domain name
  • We run a process in our application that reads messages from the ses-bounces-queue. We store the email to-address in a bounce-list table as either permanent or transient. Permanent email addresses are blocked from future emails.
  • Transient email addresses are converted to permanent addresses after 14 days
  • We always add verified/opt-in email addresses to our list. -- they emphasis that their bounce system should not be used to clean lists
Allow AWS Email Bounce Processing 
(Check this box 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 were 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 your 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 your credentials. (The secret access key only displays upon the creation of the access key.)
AWS SQS Bounce Email Queue Endpoint 
The URL for the AWS Message Queue you configured to store the bounce messages.

Under Admin > Settings > Preferences > Email Tab

Allow Email Bounce Processing 
This field should NOT be check if AWS SES is set up.
Email Bounce Address 
This field should be blank if AWS SES is set up.


Developer notes:

  • TLS1.0 must be enabled
  • Fips should be enabled

Change History

10/28/2016 
This build adds the AWS SES email handling, required if you send SES email. Instead of reading addresses from a pop3 account, it receives messages from the Amazon SQS message queue and marks records appropriately.
Retrieved from "http://wiki.kmacloud.net/index.php?title=Managing_AWS_SES_(Simple_Email_Service)&oldid=3971"