Configuring AWS

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)

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

  2. Create a Subscription to this topic. The Protocol should be Amazon SQS, and the Endpoint should be 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 statement like 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)

  1. Verify your Brightspot domain name, and create an MX record to route Email for the Brightspot domain to SES.

    This is the domain that is used in the Tool URL. Alternatively, you can specify a domain that is independent of the domain that the site is hosted on, such as the case where 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. Optionally, 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.