View a markdown version of this page

步骤 1:确保您的终端节点已准备好处理 Amazon SNS 消息 - Amazon Simple Notification Service
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

步骤 1:确保您的终端节点已准备好处理 Amazon SNS 消息

在您为 HTTP 或 HTTPS 终端节点订阅某个主题之前,您必须确保该终端节点能够处理 Amazon SNS 用于发送订阅确认和通知消息的 HTTP POST 请求。通常,这意味着创建和部署一个处理来自亚马逊 SNS 的 HTTP 请求的 Web 应用程序。例如,如果您的端点主机运行带有 Apache 和 Tomcat 的 Linux,请使用 Java servlet。当您订阅 HTTP 终端节点时,Amazon SNS 会向其发送一条订阅确认请求。创建订阅时,您的终端节点必须做好接收和处理此请求的准备。亚马逊 SNS 当时会发送此请求。在您确认订阅前,Amazon SNS 不会向终端节点发送消息。确认后,当对该主题执行发布操作时,Amazon SNS 会向终端节点发送通知。

设置您的终端节点,处理订阅确认和通知消息
  1. 您的代码将读取 Amazon SNS 向您的终端节点发送的 HTTP POST 请求的 HTTP 标头。你的代码应该寻找标题字段x-amz-sns-message-type。此字段告诉您 Amazon SNS 发送给您的消息类型。通过查看标头,您可以确定消息类型,而无需解析 HTTP 请求的正文。您需要处理如下两种类型消息:SubscriptionConfirmation 和 Notification。仅当从主题中删除订阅时,方使用 UnsubscribeConfirmation 消息。

    有关 HTTP 标头的详细信息,请参阅 HTTP/HTTPS 标题。以下 HTTP POST 请求为订阅确认消息的一个示例。

    POST / HTTP/1.1 x-amz-sns-message-type: SubscriptionConfirmation x-amz-sns-message-id: 165545c9-2a5c-472c-8df2-7ff2be2b3b1b x-amz-sns-topic-arn: arn:aws:sns:us-west-2:123456789012:MyTopic Content-Length: 1336 Content-Type: text/plain; charset=UTF-8 Host: example.com Connection: Keep-Alive User-Agent: Amazon Simple Notification Service Agent { "Type" : "SubscriptionConfirmation", "MessageId" : "165545c9-2a5c-472c-8df2-7ff2be2b3b1b", "Token" : "2336412f37f...", "TopicArn" : "arn:aws:sns:us-west-2:123456789012:MyTopic", "Message" : "You have chosen to subscribe to the topic arn:aws:sns:us-west-2:123456789012:MyTopic.\nTo confirm the subscription, visit the SubscribeURL included in this message.", "SubscribeURL" : "https://sns.us-west-2.amazonaws.com/?Action=ConfirmSubscription&TopicArn=arn:aws:sns:us-west-2:123456789012:MyTopic&Token=2336412f37...", "Timestamp" : "2012-04-26T20:45:04.751Z", "SignatureVersion" : "1", "Signature" : "EXAMPLEpH+...", "SigningCertURL" : "https://sns.us-west-2.amazonaws.com/SimpleNotificationService-f3ecfb7224c7233fe7bb5f59f96de52f.pem" }
  2. 您的代码应解析 HTTP POST 请求正文和内容类型中的 JSON 文档, text/plain 以读取构成 Amazon SNS 消息的名称/值对。使用 JSON 分析器将控制字符的转义字符转换回 ASCII 字符值(例如,将 \n 转换成换行符)。您可以使用现有 JSON 分析器(例如 Jackson JSON 处理器)或者由您自己写入。要将主题和消息字段中的文本作为有效的 JSON 发送,Amazon SNS 必须将一些控制字符转换为可包含在 JSON 文档中的转义表示。当您收到 POST 请求正文中的 JSON 文档时,必须将转义字符转换回其原始字符值。如果您想精确呈现原始主题和发布到该主题的消息,请执行此操作。如果您想验证通知的签名,这一点至关重要。签名使用原始形式的消息和主题作为待签字符串的一部分。

  3. 您的代码应对 Amazon SNS 发送的通知、订阅确认或取消订阅确认消息进行验证。使用 Amazon SNS 消息中的信息,您的终端节点可以重新创建签名。然后,您可以通过将您的签名与 Amazon SNS 发送的签名进行匹配来验证消息的内容。有关验证消息签名的更多信息,请参阅 验证 Amazon SNS 消息签名。

  4. 根据标头字段 x-amz-sns-message-type 指定的类型,您的代码将读取 HTTP 请求正文所含的 JSON 文档,并处理该消息。这里是处理两大主要消息类型的指导原则:

    SubscriptionConfirmation

    读取 SubscribeURL 值,访问此 URL。要确认订阅并通过此终端节点接收通知,必须访问 SubscribeURL URL(例如,向此 URL 发送 HTTP GET 请求)。参阅上一步中 HTTP 请求示例,查看 SubscribeURL 相关情况。有关 SubscriptionConfirmation 消息格式的更多信息,请参阅 HTTP/HTTPS 订阅确认 JSON 格式。访问 URL 时,您将获取与以下 XML 文档相似的响应。文档会在 ConfirmSubscriptionResult 元素内返回终端节点的订阅 ARN。

    <ConfirmSubscriptionResponse xmlns="http://sns.amazonaws.com/doc/2010-03-31/"> <ConfirmSubscriptionResult> <SubscriptionArn>arn:aws:sns:us-west-2:123456789012:MyTopic:2bcfbf39-05c3-41de-beaa-fcfcc21c8f55</SubscriptionArn> </ConfirmSubscriptionResult> <ResponseMetadata> <RequestId>075ecce8-8dac-11e1-bf80-f781d96e9307</RequestId> </ResponseMetadata> </ConfirmSubscriptionResponse>

    除了访问之外SubscribeURL,您还可以使用ConfirmSubscription操作确认订阅,并将SubscriptionConfirmation消息中的相应值Token设置为相应的值。如果您仅允许主题所有者和订阅所有者拥有取消订阅终端节点的权限,那么您可以通过 Amazon 签名调用 ConfirmSubscription 操作。

    通知

    读取 Subject 和 Message 值,获取已向主题发布的通知信息。

    有关 Notification 消息格式的详细信息,请参阅 HTTP/HTTPS 标题。以下 HTTP POST 请求为向终端节点 example.com.发送的通知消息的示例。

    POST / HTTP/1.1 x-amz-sns-message-type: Notification x-amz-sns-message-id: 22b80b92-fdea-4c2c-8f9d-bdfb0c7bf324 x-amz-sns-topic-arn: arn:aws:sns:us-west-2:123456789012:MyTopic x-amz-sns-subscription-arn: arn:aws:sns:us-west-2:123456789012:MyTopic:c9135db0-26c4-47ec-8998-413945fb5a96 Content-Length: 773 Content-Type: text/plain; charset=UTF-8 Host: example.com Connection: Keep-Alive User-Agent: Amazon Simple Notification Service Agent { "Type" : "Notification", "MessageId" : "22b80b92-fdea-4c2c-8f9d-bdfb0c7bf324", "TopicArn" : "arn:aws:sns:us-west-2:123456789012:MyTopic", "Subject" : "My First Message", "Message" : "Hello world!", "Timestamp" : "2012-05-02T00:54:06.655Z", "SignatureVersion" : "1", "Signature" : "EXAMPLEw6JRN...", "SigningCertURL" : "https://sns.us-west-2.amazonaws.com/SimpleNotificationService-f3ecfb7224c7233fe7bb5f59f96de52f.pem", "UnsubscribeURL" : "https://sns.us-west-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-west-2:123456789012:MyTopic:c9135db0-26c4-47ec-8998-413945fb5a96" }
  5. 确保您的终端节点使用相应的状态代码响应来自亚马逊 SNS 的 HTTP POST 消息。连接将在大约 15 秒后超时。如果您的终端节点未及时响应,Amazon SNS 会将交付视为失败的尝试。如果您的终端节点返回的状态码超出 200—4 xx 范围,则同样适用。

  6. 确保您的代码可以处理来自 Amazon SNS 的消息传送重试。如果 Amazon SNS 未能接收到从终端节点发出的发送成功响应,它将会尝试再次发送消息。这适用于包括订阅确认消息在内的所有消息。默认情况下,如果初始交付失败,Amazon SNS 最多会尝试三次重试,失败尝试之间的延迟时间设置为 20 秒。

    注意

    消息请求在大约 15 秒后超时。因此,如果交付失败是由超时造成的,Amazon SNS 会在上次尝试后大约 35 秒后重试。您可以为终端节点设置不同的发送策略。

    亚马逊 SNS 使用标x-amz-sns-message-id题字段来识别发布到亚马逊 SNS 主题的每条消息。通过将已处理消息的 ID 与传入消息的 ID 进行比较,您可以确定该消息是否为重试消息。

  7. 如果您订阅的是 HTTPS 终端节点,请确保您的终端节点拥有来自可信证书颁发机构 (CA) 的服务器证书。Amazon SNS 将仅向具有 Amazon SNS 所信任 CA 签署的服务器证书的 HTTPS 终端节点发送消息。

  8. 对您已创建的代码进行部署,以便接收 Amazon SNS 消息。当您订阅终端节点时,该终端节点必须准备好至少接收订阅确认消息。