Skip to main content

Amazon SNS

Use of external data services in AWS will make charges your account. Please make sure to perform the cleanup per the notes at the bottom of the lab.

The following Lab focuses on quick deployment of Amazon SNS and then walks through the creation of a resource with Retool Resources.

Requirements​

To configure Amazon SNS the following is required:

  • AWS Account with Administrative user
  • A Retool user created in IAM that has IAM Security Credentials (Access keys) configured

Steps​

  • Login to AWS Management Console with a user that has administrative privileges to create Amazon SNS topics.
  • Select Amazon Simple Notification Service (SNS)
  • Select Topics > Create topic
  • For type specify Standard and specify a Name for the topic of RetoolTopic. Scroll to the bottom of the screen and select Create topic
  • This will display queue information for RetoolTopic. Copy the Amazon Resource Name (ARN) of the topic so that you can provide it in the Retool Resource definition.
  • Select Subscriptions > Create subscription
  • For Protocol specify Email and for Endpoint specify your email address and then select Create subscription. This will send an email asking you to opt into the Amazon SNS Topic that you need to accept.

Create an IAM Role​

This required portion of the lab is available as a separate artifact in AWS IAM Role. Complete create a Amazon SNS Role first before continuing with the rest of the instructions.

Amazon SNS Retool Resource Definition​

  • Go to Retool Home > Resources.
  • Select Create new > Resource. Enter SNS in search field amd select it.
  • Under Configure SNS enter a name of Retool Event Topic and a description.
  • Select the appropriate region that you created the topic in (e.g., us-east-2).
  • Provide your AWS access key ID and AWS secret key ID.
  • Specify the AWS IAM Role using the ARN that you want to assume to restrict privileges to just what you need.

Test the Connection​

  • Select Test Connection to confirm the configuration is successful.
  • Select Create Resource to save the changes and make this resource accessible to developers.

Cleanup of Amazon SNS​

The following steps can be used to remove an SNS Topic

  • Go to AWS Management Console, select Amazon SNS > Topics > RetoolUniversity > Delete.
  • Go to Retool Home Page > Resources > (select Resource created previously) > … > Delete.