Amazon Simple Notification Service Developer Guide

1 Amazon Simple NotificationServiceDeveloper GuideAPI Version 2010-03-31 Amazon Simple Notification Service : Developer GuideCopyright 2014 Amazon Web services , Inc. and/or its affiliates. All rights following are trademarks of Amazon Web services , Inc.: Amazon , Amazon Web services Design, AWS, Amazon CloudFront,Cloudfront, Amazon DevPay, DynamoDB, ElastiCache, Amazon EC2, Amazon Elastic Compute Cloud, Amazon Glacier, Kindle, KindleFire, AWS Marketplace Design, Mechanical Turk, Amazon Redshift, Amazon Route 53, Amazon S3, Amazon VPC. In addition, graphics, logos, page headers, button icons, scripts, and Service names are trademarks, or trade dress of Amazon inthe and/or other countries. Amazon 's trademarks and trade dress may not be used in connection with any product or Service thatis not Amazon 's, in any manner that is likely to cause confusion among customers, or in any manner that disparages or other trademarks not owned by Amazon are the property of their respective owners, who may or may not be affiliated with, connectedto, or sponsored by Simple Notification Service Developer GuideTable of ContentsWhat is Amazon SNS?

2 1 Are You a First-Time Amazon Simple Notification Service User?.. 2 Beyond the getting started 2 Accessing Amazon 2 Common 3 Application and System Alerts .. 3 Push Email and Text 3 Mobile Push 3 Getting 4 Before You 4 Create a 4 Subscribe to a 6 Publish to a 6 Create Different Messages for Each 7 Clean 9 Using the SDK for Java .. 10 Managing 13 Overview .. 14 When to Use Access 14 Key 14 Architectural Overview .. 16 Using the Access Policy 18 Evaluation 19 Example Cases for Amazon SNS Access 22 How to Write a 27 Basic Policy 27 Element 27 Supported Data 37 Special Information for Amazon SNS 38 Amazon SNS Policy 38 Valid Amazon SNS Policy 38 Amazon SNS 39 Controlling User Access to Your AWS 40 IAM and Amazon SNS Policies 40 Amazon SNS 43 Amazon SNS 44 Amazon SNS 44 Example Policies for Amazon 45 Using Temporary Security 47 Monitoring Amazon SNS with 49 Access CloudWatch Metrics for Amazon 49 Set CloudWatch Alarms for Amazon SNS 50 Amazon SNS 51 Dimensions for Amazon Simple Notification Service 51 Amazon SNS Mobile 53 Overview.

3 54 Getting Started with 55 ADM 55 Step 1: Create a Kindle Fire App with the ADM Service 55 Step 2: Obtain a Client ID and Client 56 Step 3: Obtain an API Key .. 56 Step 4: Obtain a Registration 56 Step 5: Sending a Message to a Kindle Fire app using Amazon SNS and 57 API Version 2010-03-31iiiAmazon Simple Notification Service Developer GuideGetting Started with 59 APNS 59 Step 1: Create an iOS 60 Step 2: Obtain an APNS SSL 60 Step 3: Obtain the App Private Key .. 60 Step 4:Verify the Certificate and App Private Key .. 61 Step 5: Obtain a Device 61 Step 6: Send a Message to an iOS app using Amazon SNS and 62 Getting Started with 64 Baidu 64 Step 1: Create a Baidu 64 Step 2: Register as a Baidu 66 Step 3: Create a Baidu Cloud Push 69 Step 4: Download and Install the Android Demo 72 Step 5: Obtain a user Id and channel 76 Step 6: Send a Push Notification Message to a Mobile Endpoint using Amazon SNS 76 Getting Started with 80 GCM 81 Step 1: Create a Google API Project and Enable the GCM 81 Step 2: Obtain the Server API Key.

4 81 Step 3: Obtain a Registration ID from 82 Step 4: Send a Message to a Mobile Endpoint using 83 Getting Started with 85 MPNS 85 Step 1: Set Up Your Windows Phone App to Receive Push Notifications 86 Step 2: Get a Push Notification URI from 86 Step 3: Send a Push Notification Message to a Windows Phone app using Amazon SNS 86 Getting Started with 87 WNS 88 Step 1: Set Up Your App to Receive Push Notifications 88 Step 2: Get a Push Notification URI from 88 Step 3: Get a Package Security Identifier from 88 Step 4: Get a Secret Key from 88 Step 5: Send a Push Notification Message to an App using Amazon SNS and 88 Using Amazon SNS Mobile 90 Register Your Mobile App with 90 Add Device Tokens or Registration 91 Send a Direct Message to a Mobile 94 Send Messages to Mobile Devices Subscribed to a 94 Send Custom Platform-Specific Payloads to Mobile 95 Amazon SNS 97 TTL Message Attributes for Push Notification 98 Precedence Order for Determining 98 Specifying TTL with the AWS Management 99 Specifying TTL with the AWS 99 Amazon SNS Mobile Push 99 API 101 Sending Messages to Amazon SQS 108 Step 1.

5 Get the ARN of the queue and the 109 Step 2. Give permission to the Amazon SNS topic to send messages to the Amazon SQS 110 Step 3. Subscribe the queue to the Amazon SNS 111 Step 4. Give users permissions to the appropriate topic and queue 111 Adding a policy to an IAM user or 112 Adding a policy to a topic or 112 Step 113 Sending Messages to a Queue in a Different 114 API Version 2010-03-31ivAmazon Simple Notification Service Developer GuideQueue Owner Creates 114 User Who Does Not Own the Queue Creates 116 Using an AWS CloudFormation Template to Create a Topic that Sends Messages to Amazon 117 Using an AWS CloudFormation Template to Set Up Topics and Queues Within an 118 Sending and Receiving SMS 123 Task 1: Assign a Topic Display 124 Task 2: Subscribe to a Topic Using the SMS 126 Task 3: Publish a 128 Task 4: Cancel SMS 130 Sending Messages to HTTP/HTTPS 132 Step 1.

6 Make sure your endpoint is ready to process Amazon SNS 133 Step 2: Subscribe the HTTP/HTTPS endpoint to the Amazon SNS 136 Step 3: Confirm the 137 Step 4: Set the delivery retry policy for the subscription (optional).. 137 Step 5: Give users permissions to publish to the topic (optional).. 137 Step 6: Send messages to the HTTP/HTTPS 139 Setting Amazon SNS Delivery Retry Policies for HTTP/HTTPS 139 Applying Delivery Policies to Topics and 141 Setting the Maximum Receive 142 Immediate Retry 145 Pre-Backoff 146 Backoff 147 Post-Backoff 149 Certificate Authorities for HTTPS 150 Verifying Message 163 Example Code for an Endpoint Java 165 Message 170 Message Attribute Items and 170 Data 171 Reserved Message 171 Using Message Attributes with the AWS 172 Appendix.

7 Message and JSON 173 HTTP/HTTPS 174 HTTP/HTTPS Subscription Confirmation JSON 175 HTTP/HTTPS Notification JSON 177 HTTP/HTTPS Unsubscribe Confirmation JSON 179 SetSubscriptionAttributes Delivery Policy JSON 181 SetTopicAttributes Delivery Policy JSON 182 Appendix: Large Payload and Raw Message Delivery .. 183 Enabling Raw Message Delivery with the AWS Management 183 Document History .. 185 API Version 2010-03-31vAmazon Simple Notification Service Developer GuideWhat is Amazon SimpleNotification Service ? Amazon Simple Notification Service ( Amazon SNS) is a web Service that coordinates and manages thedelivery or sending of messages to subscribing endpoints or clients. In Amazon SNS, there are two typesof clients publishers and subscribers also referred to as producers and consumers.

8 Publisherscommunicate asynchronously with subscribers by producing and sending a message to a topic, which isa logical access point and communication channel. Subscribers ( , web servers, email addresses, Amazon SQS queues) consume or receive the message or Notification over one of the supported protocols( , Amazon SQS, HTTP/S, email, SMS) when they are subscribed to the using Amazon SNS, you (as the owner) create a topic and control access to it by defining policiesthat determine which publishers and subscribers can communicate with the topic. A publisher sendsmessages to topics that they have created or to topics they have permission to publish to. Instead ofincluding a specific destination address in each message, a publisher sends a message to the SNS matches the topic to a list of subscribers who have subscribed to that topic, and deliversthe message to each of those subscribers.

9 Each topic has a unique name that identifies the Amazon SNSendpoint for publishers to post messages and subscribers to register for notifications. Subscribers receiveall messages published to the topics to which they subscribe, and all subscribers to a topic receive thesame Version 2010-03-311 Amazon Simple Notification Service Developer GuideAre You a First-Time Amazon Simple NotificationService User?If you are a first-time user of Amazon SNS, we recommend that you begin by reading the followingsections: What is Amazon SNS The rest of this section includes a video that introduces Amazon SNS andwalks you through the example presented in Getting Started with Amazon Simple NotificationService (p. 4), and presents common use-case scenarios.

10 Getting Started The Getting Started with Amazon Simple Notification Service (p. 4) section walksyou through creating a topic, subscribing to it, publishing a message to it, unsubscribing from it, andfinally, deleting the the getting started sectionBeyond the getting started section, you'll probably want to learn more about Amazon SNS following sections provide detailed information about working with Amazon SNS: Managing Access to Your Amazon SNS Topics (p. 13)You have detailed control over which endpoints a topic allows, who is able to publish to a topic, andunder what conditions. This section shows you how to control access through the use of access controlpolicies. Monitoring Amazon SNS with CloudWatch (p. 49) Amazon SNS and CloudWatch are integrated so you can collect, view, and analyze metrics for everyactive Amazon SNS topic.