How to execute AWS & Azure REST APIs using Postman

There are many reasons you may want to use an application like Postman to test REST APIs, for example:

• You need to confirm if the MID server can reach 3rd party services such as Azure/AWS.
• You would like to verify the data structure that ServiceNow receives from 3rd party services
• You would like to confirm that the values you believe are being sent/received are being sent/received over REST

All

Azure

1. Download and install Postman (postman.com)
2. Click Here to download the Azure Postman collection (getpostman.com)
3. Make sure you are in the "Azure REST" environment, then select "Manage Environment" with the settings cog
   
   
4. Set your environment variables in the "Current Value" column:
   
   
5. Variables:
   
   1. tenantId: Azure Dashboard > Azure Active Directory > Manage/Properties > Copy "Directory ID"
   2. clientId: Azure Dashboard > Azure Active Directory > App Registrations > Select/Create > Copy "Application ID"
   3. clientSecret: Select App Registration > Settings > Keys > Create new "Passwords" > Copy Secret Key "Value"
   4. subscriptionId: Azure Dashboard > Subscriptions > Select > Overview > Copy "Subscription ID"
   5. action: API call that you wish to make (e.g: resourceGroups?api-version=2014-04-01)
6. If done correctly, you should be able to execute the "Get AAD Token" step in order to obtain the Bearer token for authentication for API calls. You can now execute the "Azure REST API Request" action and receive a response from Azure
   
   
   
   
7. Note that some modifications may be necessary (such as the HTTP action or the URL) in order to make specific API requests. You can defer to the "Azure Resource Explorer" (link in Additional Info) for further details on how the API call should be formatted.

AWS

1. Download and install Postman
2. Click Here to download the AWS Postman collection
3. Make sure you are in the "AWS REST" environment, then select "Manage Environment" with the Settings cog
   
   
   
   
4. Set your environment variables in the "Current Value" column
   
   
5. Variables
   
   1. accessKey: Programmatic API access key from configured IAM user
   2. secretKey: Programmatic API secret key from configured IAM user
   3. contentType: Generic JSON format since Postman's default value will cause errors
   4. service: Name of the AWS API service you're attempting to query
   5. region: Optional. Specific region for the query, if desired
   6. version: Enforce versioning for V4 signing protocol, which is what Postman will be using for authentication
   7. action: API call you're wanting to make
6. If done correctly, after filling out these variables you should be able to get a response by clicking "Send"
   
   
   
   
7. Note that you may need to change the HTTP request type (GET, POST, PUT) depending on the desired API call. You may also need to modify the URL to accommodate additional requirements depending on the API call (e.g: Buckets for S3 requests). You can reference the API guides in Additional Information for more details on how the API call should be formatted.

• AWS Service Names 
• AWS API Reference 
• Azure REST API Browser
• Azure Resource Explorer (See the REST API responses made from/by Azure, for a better understanding of proper query format)