SETUP.md

AWS SNS Setup Instructions

Create an SNS Topic

Visit the AWS Simple Notifications Service (SNS) home page and create a new topic: https://eu-west-1.console.aws.amazon.com/sns/v3/home

We called ours SESNotifications and then clicked Next step. You will see a page where you can configure your SNS topic:

Ignore all the optional configurations and just scroll to the bottom of the page and click Create topic:

You will then see a confirmation page saying your topic was created successfully:

Create SNS Subscription to the Topic

On this page, scroll till you find the Create subscription button: (Click it)

Once you have selected/input the relevant data, click the Create subscription button:

You should see a confirmation that your subscription was created successfully:

Configuring Notifications on Amazon SES Console

This section follows and expands on the official instructions: https://docs.aws.amazon.com/ses/latest/DeveloperGuide/configure-sns-notifications.html

Once you have created the SNS Topic, visit the SES home page and click on Email Addresses: https://eu-west-1.console.aws.amazon.com/ses

Click on the verified email address you want to configure SNS notifications for:

In the Notifications section, click on Edit configuration:

Select the SNS topic we created above for all the types of notification then click Save Config:

Your configuration should now look something like this:

Test it!!

In the Lambda configuration page https://eu-west-1.console.aws.amazon.com/lambda/home?region=eu-west-1#/functions/aws-ses-lambda-v1 configure a bounce event to an email address you know does not exist:

Run the bounce event in the Lambda console:

You will see a "success" message confirming that the aws-ses-lambda attempted to send the email to the [email protected] address (which we know will fail). Our lambda function and AWS SES does not know that the [email protected] address will bounce. That's the reason we need to have the SNS topic so we can monitor bounce events!

The SNS bounce notification event is saved to S3 thanks to #12 https://ademoapp.s3-eu-west-1.amazonaws.com/event.json

For the purposes of testing our parser, we save this event JSON in: test/fixtures/sample_sns_bounce.json

Now we can parse the notification!