Configuring AWS for email submissions

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

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.

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 (console).

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.

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 tool 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.