Amazon AWS SNS

the amazon aws sns connector enables automated subscription management and message publishing to sns topics, facilitating robust messaging workflows amazon aws sns (simple notification service) is a flexible, fully managed pub/sub messaging and mobile notifications service for coordinating the delivery of messages to subscribing endpoints and clients the amazon aws sns connector for swimlane turbine allows users to automate the subscription of endpoints to sns topics, enabling efficient and targeted distribution of security alerts and notifications by integrating with aws sns, swimlane turbine users can streamline their security operations, ensuring timely and relevant communication across various protocols and services, enhancing their overall security posture with minimal manual intervention limitations none to date supported versions this connector supports the latest version of the amazon aws sns api additional docs https //docs aws amazon com/sns/latest/api/welcome html configuration prerequisites to utilize the amazon aws sns connector within swimlane turbine, ensure you have the following aws credentials for authentication with the following parameters access key your aws access key id secret key your aws secret access key region name the aws region your sns topic resides in authentication methods to effectively utilize the amazon aws sns connector with swimlane turbine, ensure you have the following prerequisites aws credentials authentication with the following parameters access key id your unique aws identifier key secret key your secret key for aws api access region name the aws region your organization operates in capabilities this connector provides the following capabilities subscribe an endpoint subscribe an endpoint subscribes an endpoint to an amazon sns topic amazon aws sns's documentation for this action can be found https //docs aws amazon com/organizations/latest/apireference/api describeaccount html configurations amazon aws sns authentication authenticates using aws credentials configuration parameters parameter description type required access key aws access key string required secret key aws secret key string required region name the aws region where you want to create new connections string required role arn optional role arn to assume leave blank unless tasks need to assume a different role string optional external id external id to assume iam role optional value used for assuming roles can be added, or removed in trusted relationships of target role string optional session token use if a session token is provided when switching roles string optional role session name defaults to sessionfromswimlane \<hash> when no value is provide string optional actions subscribe an endpoint subscribes an endpoint to an amazon sns topic using the specified topicarn and protocol input argument name type required description topicarn string required the arn of the topic you want to subscribe to protocol string required the protocol that you want to use supported protocols include http, https, email, email json, sms, sqs, application, lambda, firehose endpoint string optional the endpoint that you want to receive notifications endpoints vary by protocol for http/https, it is a url for email/email json, it is an email address for sms, it is a phone number for sqs, it is the arn of an amazon sqs queue for application, it is the endpointarn of a mobile app and device for lambda, it is the arn of a lambda function for firehose, it is the arn of an amazon kinesis data firehose delivery stream attributes object optional a map of attributes with their corresponding values includes options like deliverypolicy, filterpolicy, filterpolicyscope, rawmessagedelivery, redrivepolicy, subscriptionrolearn, replaypolicy, and replaystatus attributes deliverypolicy string optional the policy that defines how amazon sns retries failed deliveries to http/s endpoints attributes filterpolicy string optional the simple json object that lets your subscriber receive only a subset of messages, rather than receiving every message published to the topic attributes filterpolicyscope string optional this attribute lets you choose the filtering scope by using one of the following string value types messageattributes (default) or messagebody attributes rawmessagedelivery boolean optional when set to true, enables raw message delivery to amazon sqs or http/s endpoints attributes redrivepolicy string optional when specified, sends undeliverable messages to the specified amazon sqs dead letter queue attributes subscriptionrolearn string optional the arn of the iam role that has permission to write to the firehose delivery stream and lists amazon sns as a trusted entity attributes replaypolicy string optional adds or updates an inline policy document for a subscription to replay messages stored in the specified amazon sns topic attributes replaystatus string optional retrieves the status of the subscription message replay, which can be one of the following completed, in progress, failed, or pending returnsubscriptionarn boolean optional sets whether the response from the subscribe request includes the subscription arn, even if the subscription is not yet confirmed default is false input example {"topicarn" "string","protocol" "http","endpoint" "http //example com","attributes" {"deliverypolicy" "healthyretrypolicy","filterpolicy" "store","filterpolicyscope" "messageattributes","rawmessagedelivery"\ true,"redrivepolicy" "deadlettertargetarn","subscriptionrolearn" "arn\ aws\ iam 123456789012\ role/snssendtofirehose","replaypolicy" "starttime","replaystatus" "in progress"},"returnsubscriptionarn"\ true} output parameter type description subscriptionarn string output field subscriptionarn output example {"subscriptionarn" "string"} response headers header description example content type the media type of the resource application/json date the date and time at which the message was originated thu, 01 jan 2024 00 00 00 gmt