Amazon SNS Connector

Manage subscriptions, topics, and messages within Amazon (AWS) SNS

Connections

AWS Role ARN

Connect to AWS using an assumed role

To enable the IAM role authentication begin by logging into the AWS Console and navigate to Identity and Access Management (IAM).

To create a user and generate credentials:

1. Navigate to Users and select Create User.

• Provide a User name and check the box providing them user access to the AWS Management Console if needed.
• Once completed with the User creation, copy the ARN provided in the summary for a later step.

2. To obtain the ARN for an existing User, click on the designated username from the Users page and the ARN will be provided in the summary section.

3. From the summary section, select Create access key

• Select Third-party service as the access key type and select next.
• Set a description and select create access key.
• Copy the Access Key and Secret access key and enter those into the connection configuration of your integration along with the ARN.

To create and assign a user a role:

1. Navigate to Roles and select Create Role.

• Select Custom Trust Policy for the Trusted entity types
• Copy the following statement into the statement console. Making sure to replace the ARN with the user's actual ARN from the previous section

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "ARN"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

• When adding permissions provide the AmazonSNSFullAccess permission
• Complete remaining steps and select Create Role

Input	Comments	Default
Role ARN	An AWS IAM Role ARN
Access Key ID	An AWS IAM Access Key ID
Secret Access Key	An AWS IAM Secret Access Key
External ID	Provides enhanced security measures to the connection. Optional, but recommended. Please check AWS docs for more information.

AWS SNS Access Key and Secret

Authenticates requests to Amazon SNS using an API Key and API Secret

An AWS IAM access key pair is required to interact with Amazon SNS. Make sure that the key pair you generate in AWS has proper permissions to the SNS resources you want to access. Read about Amazon SNS IAM policies in the AWS docs.

Input	Comments	Default
Access Key ID	An AWS IAM Access Key ID
Secret Access Key	An AWS IAM Secret Access Key

Triggers

Subscription Trigger

Confirm subscription and unsubscribe requests and validate SNS messages

Input	Comments	Default
Parse Message	When enabled the message from SNS will be parsed as JSON and returned. If disabled it will be passed as received.	false

Actions

Create Topic

Create an Amazon SNS Topic

Input	Comments	Default
AWS Region	AWS provides services in multiple regions, like us-west-2 or eu-west-1.
Name	Provide a string for the name of the topic.
Connection

Delete Topic

Delete an Amazon SNS Topic

Input	Comments	Default
AWS Region	AWS provides services in multiple regions, like us-west-2 or eu-west-1.
Topic Arn	An Amazon SNS topic is a logical access point that acts as a communication channel.
Connection

Get Topic Attributes

Retrieves the attributes of an Amazon SNS Topic.

Input	Comments	Default
AWS Region	AWS provides services in multiple regions, like us-west-2 or eu-west-1.
Topic Arn	An Amazon SNS topic is a logical access point that acts as a communication channel.
Connection

List Opt Out Numbers

List all opt out numbers

Input	Comments	Default
AWS Region	AWS provides services in multiple regions, like us-west-2 or eu-west-1.
Next Token	Specify the pagination token that's returned by a previous request to retrieve the next page of results.
Connection

List Subscriptions

Retrieve the subscriptions of an Amazon SNS Topic

Input	Comments	Default
Connection
AWS Region	AWS provides services in multiple regions, like us-west-2 or eu-west-1.
Topic Arn	An Amazon SNS topic is a logical access point that acts as a communication channel.
Fetch All	Turn this on to fetch all paginated subscriptions. If turned off, only 100 subscriptions will be returned.	false
Next Token	Specify the pagination token that's returned by a previous request to retrieve the next page of results.

List Topics

List available Amazon SNS Topics

Input	Comments	Default
Connection
AWS Region	AWS provides services in multiple regions, like us-west-2 or eu-west-1.
Fetch All	Turn this on to fetch all paginated topics. If turned off, only 100 topics will be returned.	false
Next Token	Specify the pagination token that's returned by a previous request to retrieve the next page of results.

Publish Batch Messages

Publishes up to ten messages to the specified Amazon SNS Topic

Input	Comments	Default
AWS Region	AWS provides services in multiple regions, like us-west-2 or eu-west-1.
Topic Arn	An Amazon SNS topic is a logical access point that acts as a communication channel.
Message Entries	To add a Binary Message add a Template Field containing a Buffer from a previous field to the BinaryValue attribute. For MessageAttributes data types, see: https://docs.aws.amazon.com/sns/latest/dg/sns-message-attributes.html	[ { "Id": "AN_ID", "Message": "A_MESSAGE", "Subject": "A_SUBJECT", "MessageStructure": "A_MESSAGE_STRUCTURE", "MessageAttributes": { "": { "DataType": "Number", "StringValue": "123" } }, "MessageDeduplicationId": "A_MESSAGE_DEDUPLICATION_ID", "MessageGroupId": "A_MESSAGE_GROUP_ID" }, { "Id": "AN_ID", "Message": "A_MESSAGE", "Subject": "A_SUBJECT", "MessageStructure": "A_MESSAGE_STRUCTURE", "MessageAttributes": { "": { "DataType": "String.Array", "StringValue": "["test", true, 123]" } }, "MessageDeduplicationId": "A_MESSAGE_DEDUPLICATION_ID", "MessageGroupId": "A_MESSAGE_GROUP_ID" }, { "Id": "AN_ID", "Message": "A_MESSAGE", "Subject": "A_SUBJECT", "MessageStructure": "A_MESSAGE_STRUCTURE", "MessageAttributes": { "": { "DataType": "String", "StringValue": "test" } }, "MessageDeduplicationId": "A_MESSAGE_DEDUPLICATION_ID", "MessageGroupId": "A_MESSAGE_GROUP_ID" }, { "Id": "AN_ID", "Message": "A_MESSAGE", "Subject": "A_SUBJECT", "MessageStructure": "A_MESSAGE_STRUCTURE", "MessageAttributes": { "": { "DataType": "Binary", "BinaryValue": "ADD A BUFFER HERE WITH A TEMPLATE FIELD" } }, "MessageDeduplicationId": "A_MESSAGE_DEDUPLICATION_ID", "MessageGroupId": "A_MESSAGE_GROUP_ID" } ]
Connection

Publish Message

Publish a message to an Amazon SNS Topic

Input	Comments	Default
AWS Region	AWS provides services in multiple regions, like us-west-2 or eu-west-1.
Message	Provide a string for the message you would like to send.
Topic Arn	An Amazon SNS topic is a logical access point that acts as a communication channel.
Message Attributes	For each item, provide a key value pair representing a message attribute, to supply a binary you must provide a Buffer to the key value. When determining your message attributes, it is important that you follow the specifications listed in the Amazon SNS docs: https://docs.aws.amazon.com/sns/latest/api/API_MessageAttributeValue.html
Connection

Publish SMS

Publish an SMS message to an Amazon SNS Topic

Input	Comments	Default
AWS Region	AWS provides services in multiple regions, like us-west-2 or eu-west-1.
Message	Provide a string for the message you would like to send.
Phone Number	Provide a phone number that you would like to subscribe to your topic.
Connection

Subscribe to Topic

Subscribe to an Amazon SNS Topic

Input	Comments	Default
AWS Region	AWS provides services in multiple regions, like us-west-2 or eu-west-1.
Topic Arn	An Amazon SNS topic is a logical access point that acts as a communication channel.
protocol	When you subscribe an endpoint to a topic, you must specify which protocol to use when this topic receives messages.	https
Endpoint	The endpoint that you want to receive notifications. This could be an email address, URL, phone number, or SQS/application/Lambda/Firehose ARN.
Connection

Unsubscribe from a Topic

Unsubscribe from an Amazon SNS Topic

Input	Comments	Default
AWS Region	AWS provides services in multiple regions, like us-west-2 or eu-west-1.
Subscription Arn	The unique identifier for a topic subscription
Connection