Creating workflows for AWS SNS subscriptions

Let Oomnitza be your single source of truth!

You'll get visibility of SNS subscriptions as data from AWS SNS is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and AWS SNS in minutes

Get the information and insights that you need by creating configurable workflows to retrieve a list of SNS subscriptions for a region.

Navigation

Before you start

Creating workflows

Before you start

Before you can create the integration with Oomnitza, you need to have added your credentials to Oomnitza. For further information, refer to Adding your AWS credentials to Oomnitza.

Adding global variables

To save time entering information when you create the integration, you can add your AWS version and region as a global variable in Oomnitza.

Procedure

1. Click Configuration>General>Global Settings.
2. Click Add new variable .
3. Add the following variable as the key AWS.Version
4. Enter your AWS API Version as the value. For example, the current API version for Amazon S3 is2010-05-08. See AWS Documentation: API Versions
5. Save your changes.
6. Repeat the steps above to add your AWS.Region as a global variable. Enter your region as the value, such asus-east-1. See Regions, Availability Zones, and Local Zones.

Creating workflows

To create a user workflow, you must complete these steps:  

1. Click Configuration > Workflows 
2. Click Add .
3. Use search to find and select the Users object.
4. Edit the Begin Block and add rules to trigger the workflow. For example, if you set the Actions to Schedule and add a rule so that the Email Equals <EmployeeEmail> you can trigger a workflow to fetch a user matching a certain name on a specific date. Refer to Using the Begin block. 
5. Drag and drop the API block onto the Sandbox.
6. Click Edit on the API block and enter AWS SNS in the search field. 
7. Select a preset from the list below. To choose a preset, click the forward arrow (>).
   
   • Amazon AWS SNS List Subscriptions
   • Amazon AWS SNS List Subscriptions by Topic
8. Select the credentials that you created in Adding your AWS credentials to Oomnitza.
9. Enter any mandatory information when prompted.
10. Select Advanced Mode and go to the Response tab. You can map the entire response by placing {{response}} in the Response field and mapping it to a custom long text Oomnitza field, such as API Response. Once you have the entire response, you can then parse the JSON response values to custom Oomnitza fields, as per the example below.
11. Connect the Blocks. 
12. Save, validate, and activate your workflow.

Using the SNS List Subscriptions preset

The AWS SNS List Subscriptions preset returns a list of the requester's subscriptions. Each call returns a limited list of subscriptions, up to 100.

See AWS SNS Docs: ListSubscriptions.

Using the SNS List Subscriptions by Topic preset

The Amazon AWS List Subscriptions by Topic preset returns a list of the subscriptions to a specific topic. Each call returns a limited list of subscriptions, up to 100. You need to supply the ARN of the topic for which you wish to find subscriptions, such as arn%3Aaws%3Asns%3Aus-east-2%3A123456789012%3AMy-Topic

See AWS SNS Docs: ListSubscriptionsByTopic.

Reference articles for workflows

• Mapping positive and negative responses
• Troubleshooting workflows 
• Using the API block