Configuring AWS for email submissions

Developers perform this task.

Brightspot Mail Publishing uses the following Amazon services to receive incoming mail. This topic provides guidelines for configuring these services.

S3 (Simple Storage Service)

Create an S3 bucket, for example example-dev-ses-inbox-bucket. Ensure that your IAM profile has read access to this bucket. For more information, see Amazon S3 and AWS Identity and Access Management.

SQS (Simple Queue Service)

Create an SQS queue, for example example-dev-ses-inbox-queue. Ensure your IAM profile has full access to this queue (All SQS Actions (SQS:\\*)). For more information, see Creating an Amazon SQS Queue.

SNS (Simple Notification Service)

To configure an SNS instance:

  1. Create an SNS topic, for example, example-dev-ses-inbox-topic.

  2. Create a Subscription to this topic. The Protocol is Amazon SQS, and the Endpoint is the ARN of your SQS queue, for example arn:aws:sqs:us-east-1:555555555555:example-dev-ses-inbox-queue.

  3. Edit the Policy Document for your SQS queue, and add a stanza such as the following in order to grant the SNS topic permission to send messages to the queue.

    {
      "Sid": "Sid1449524689678",
      "Effect": "Allow",
      "Principal": {
        "AWS": "*"
      },
      "Action": "SQS:SendMessage",
      "Resource": "arn:aws:sqs:us-east-1:555555555555:example-dev-ses-inbox-queue",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:us-east-1:555555555555:example-dev-ses-inbox-topic"
        }
      }
    }
    

For more information, see Amazon Simple Notification Service.

SES (Simple Email Service)

To configure an SES instance:

  1. Verify your Brightspot domain name, and create an MX record to route email for the Brightspot domain to SES. This is the domain used in the tool URL. Alternatively, you can specify a domain that is independent of the domain on which the site is hosted, such as the case in which you want to hide the CMS’s URL from email contributors.
  2. Create an Email Receiving Rule Set. You can only have one active rule set, so call it default-rule-set.
  3. Create a Rule, for example example-dev-ses-inbox-rule.
  4. Add your Brightspot domain as a recipient, for example, brightspot.dev.example.com.
  5. Add an S3 action:
    1. Select the S3 bucket as created above (example-dev-ses-inbox-bucket).
    2. (Optional) Specify an object key prefix (subfolder).
    3. Select the SNS topic as created above (example-dev-ses-inbox-topic).

For more information, see Amazon Simple Email Service.

Note

If you want to receive bounce and complaint notifications from Amazon SES, configure notifications in the Amazon SES console, and take note of the SQS queue names for the bounce and complaint notifications. The Brightspot configuration that supports bounce and complaint notifications requires these SQS queue names. For more information, see Configure Bounce and Complaint Notifications in Amazon SES and Configuring the bounce and complaint interface.