The AWS Simple Notification Service Connector enables you to integrate with Amazon Simple Notification Service (Amazon SNS) to deliver messages from producers to consumers based on topics they subscribe to.
The actions in this connector provide you the following capabilities over the endpoints, subscriptions, topics and messages in your Amazon SNS managed service:
Create and delete endpoints for a device and mobile app
List, confirm and unsubscribe subscriptions
Create, list, subscribe and delete topics
Send messages to a topic
Validate the signature of a message
This component is based on the AWS SDK for .NET v3.
To use this connector you must have:
An AWS account, so you can use Amazon SNS
An AWS access key (access key ID and secret access key)
See AWS documentation for detailed information and instructions for getting started, developing, and working with Amazon SNS.
To authenticate in Amazon SNS from this connector, you need the following information:
The access key ID of your AWS access key
The secret access key of your AWS access key
The AWS Region of the service endpoint you want to connect. To reduce latency, you should choose a region close to your application server. See the API documentation for the list of region Names.
Each time you run an action from the connector, the authentication in Amazon SNS is performed as follows (see this logic in GetAmazonCredentials action):
If the AWSCredentials input parameter is passed (this parameter is mandatory), these values are used to authenticate.
If any of these values is not passed, then an exception is raised: “Invalid credentials to Amazon SNS service."
Use the above information to fill in the following site properties available in the AmazonSNS_IS module:
Access Key
Secret Access Key
Region (default value is "USEast1")
The connector uses the values in these site properties as the default AWS credentials to authenticate in Amazon SNS.
Alternatively, you can specify different credentials when invoking an action from the connector in your logic by using the AWSCredentials input parameter:
If the AWSCredentials input parameter is passed (the parameter isn’t mandatory), these values are used to authenticate.
Otherwise, the authentication uses the values in the Access Key, Secret Access Key, and Region site properties.
If the values in the site properties are not set, an exception is raised: “Invalid configuration. Please validate the values."
With this design, you have the flexibility to define a set of AWS credentials for specific actions, while using the ones configured in the site properties as default credentials for the remaining actions.