Amazon SNS 访问控制的案例 - Amazon Simple Notification Service
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

Amazon SNS 访问控制的案例

本节介绍了针对访问控制的几个典型使用案例。

Grant Amazon Web Services 账户 访问主题

假设您在 Amazon SNS 系统中有一个主题。最简单的情况是,您希望让您的一个或多个 Amazon Web Services 账户 访问某个特定主题操作(例如,Publish)。

您可以使用 Amazon SNS API 操作完成此操作。AddPermission. 它需要一个主题, Amazon Web Services 账户 ID、操作列表和标签,并自动在主题访问控制策略中创建新语句。这样,您不需要编写自己的策略,因为 Amazon SNS 将自动为您征程新的策略语句。随后,您能使用标签通过调用RemovePermission取消这个策略语句。

例如,如果您将AddPermission主题为 arn: aws: sns: us-east-2:444455556666: My的主题,与 Amazon Web Services 账户 中国人民共和国的Publish操作和标签grant-1234-publish,Amazon SNS 将生成并插入以下访问控制策略声明:

{ "Statement": [{ "Sid": "grant-1234-publish", "Effect": "Allow", "Principal": { "AWS": "111122223333" }, "Action": ["sns:Publish"], "Resource": "arn:aws:sns:us-east-2:444455556666:MyTopic" }] }

添加此语句之后,具有 Amazon Web Services 账户 1111-2222-3333 可以向该主题发布消息。

限制 HTTPS 订阅

在以下示例中,您可以将通知传输协议限定为 HTTPS。

您需要了解如何为该主题编写您自己的策略,因为 Amazon SNSAddPermission操作不让您在授权某人访问您的主题的权限时指定协议限制。这样,您可编写你自己的策略,然后使用SetTopicAttributes操作为您新的策略设置新主题Policy属性。

以下完整策略示例授予 Amazon Web Services 账户 ID 1111-2222-3333 订阅一个主题的通知。

{ "Statement": [{ "Sid": "Statement1", "Effect": "Allow", "Principal": { "AWS": "111122223333" }, "Action": ["sns:Subscribe"], "Resource": "arn:aws:sns:us-east-2:444455556666:MyTopic", "Condition": { "StringEquals": { "sns:Protocol": "https" } } }] }

向 Amazon SQS 队列发布消息

在本使用案例中,您希望从您的主题发布消息至 Amazon SQS 队列。与 Amazon SNS 一样,Amazon SQS 使用 Amazon 访问控制策略语言。若要允许 Amazon SNS 发送消息,您将需要使用 Amazon SQS 操作SetQueueAttributes以在队列上设置策略。

此外,您需要了解如何编写自己的策略,因为 Amazon SQSAddPermission操作不会创建带有条件的策略语句。

注意

以下展示的例子是一个 Amazon SQS 策略(对您队列的访问进行控制),而不是一个 Amazon SNS 策略(对您主题的访问进行控制)。这些操作都是 Amazon SQS 操作,并且资源是队列的 Amazon 资源名称 (ARN)。您可通过QueueArn操作检索队列的GetQueueAttributes属性决定队列的 ARN。

{ "Statement": [{ "Sid": "Allow-SNS-SendMessage", "Effect": "Allow", "Principal": { "Service": "sns.amazonaws.com" }, "Action": ["sqs:SendMessage"], "Resource": "arn:aws:sqs:us-east-2:444455556666:MyQueue", "Condition": { "ArnEquals": { "aws:SourceArn": "arn:aws:sns:us-east-2:444455556666:MyTopic" } } }] }

这种策略,根据发送到队列信息的信息来源,利用aws:SourceArn条件限制对队列的访问。仅当消息来自您自己的主题时,您才可以使用这种策略允许 Amazon SNS 向您的队列发送消息。在这种情况下,您可以指定一个特定的主题,主题的 ARN 是 arn: aws: s: 美国-东-2:444455556666: MyTopic。

前述策略是 Amazon SQS 策略的一个示例,可以编写并添加到特定队列。它将授予对 Amazon SNS 和其他Amazon服务。Amazon SNS 为所有新创建的主题授予默认策略。默认策略授予所有其他 Amazon 服务访问您的主题的权限。此默认策略使用aws:SourceArn条件来确保Amazon服务访问您的主题仅代表Amazon您拥有的资源。

允许 Amazon S3 事件通知发布到一个主题

在本例中,您希望配置一个主题策略以便另外一个 Amazon Web Services 账户 的 Amazon S3 存储桶可以发布到您的主题。有关从 Amazon S3 发布通知的更多信息,请转到设置存储桶事件的通知.

这个样例假定您编写自己的策略然后使用SetTopicAttributes操作为您新建策略设定主题Policy的属性。

以下示例语句使用SourceAccount条件,确保只有 Amazon S3 所有者账户才能访问该主题。在本示例中,主题所有者是 111122223333,Amazon S3 所有者是 444455556666。该示例指出所拥有的任何 Amazon S3 存储桶都可以向 MyTopic 发布信息。

{ "Statement": [{ "Effect": "Allow", "Principal": { "Service": "s3.amazonaws.com" }, "Action": "sns:Publish", "Resource": "arn:aws:sns:us-east-2:111122223333:MyTopic", "Condition": { "StringEquals": { "AWS:SourceAccount": "444455556666" } } }] }

向 Amazon SNS 发布事件时,以下服务支持aws:SourceAccount

  • Amazon API Gateway

  • Amazon CloudWatch

  • Amazon DevOps Guru

  • Amazon DynamoDB

  • Amazon ElastiCache

  • Amazon GameLift

  • Amazon Pinpoint 短信和语音 API

  • Amazon RDS

  • Amazon Redshift

  • Amazon Simple Storage Service

  • Amazon S3 Glacier

  • Amazon SES

  • Amazon CodeCommit

  • Amazon Directory Service

  • Amazon Lambda

  • Amazon Systems Manager Incident Manager

允许 Amazon SES 向其他账户拥有的主题发布

您可以允许另一个Amazon服务发布到另一个主题 Amazon Web Services 账户 . 假设您登录了 111122223333 账户,打开了 Amazon SES 并创建了一封电子邮件。要将有关此电子邮件的通知发布到 44455556666 账户拥有的 Amazon SNS 主题,您需要创建一个如下所示的策略。为此,您需要提供有关委托人(其他服务)和每个资源的所有权的信息。这些区域有:Resource语句提供主题 ARN,其中包括主题所有者的帐户 ID 444455556666。这些区域有:"aws:SourceOwner": "111122223333"语句指定您的帐户拥有该电子邮件。

{ "Version": "2008-10-17", "Id": "__default_policy_ID", "Statement": [ { "Sid": "__default_statement_ID", "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": "SNS:Publish", "Resource": "arn:aws:sns:us-east-2:444455556666:MyTopic", "Condition": { "StringEquals": { "aws:SourceOwner": "111122223333" } } } ] }

向 Amazon SNS 发布事件时,以下服务支持aws:SourceOwner

  • Amazon API Gateway

  • Amazon CloudWatch

  • Amazon DevOps Guru

  • Amazon DynamoDB

  • Amazon ElastiCache

  • Amazon GameLift

  • Amazon Pinpoint 短信和语音 API

  • Amazon RDS

  • Amazon Redshift

  • Amazon Simple Storage Service

  • Amazon S3 Glacier

  • Amazon SES

  • Amazon CodeCommit

  • Amazon Directory Service

  • Amazon Lambda

  • Amazon Systems Manager Incident Manager

aws:SourceAccountaws:SourceOwner

这些区域有:aws:SourceAccountaws:SourceOwner条件键每个都由一些Amazon服务发布到 Amazon SNS 主题时。当受支持时,该值将是 12 位Amazon服务代表其发布数据的帐户 ID。一些服务支持其中一项,一些服务支持另一项。

允许中的组织中的账户Amazon Organizations发布到其他账户中的主题

这些区域有:Amazon Organizations服务可帮助您集中管理账单、控制访问权限和安全性以及跨 Amazon Web Services 账户 .

您可以在 Organizations 控制台中找到您的组织 ID。有关更多信息,请参阅 。从管理帐户查看组织的详细信息.

在此示例中,任何 Amazon Web Services 账户 组织中的职务myOrgId可向 Amazon SNS 主题发布消息MyTopic在帐户中444455556666. 该策略使用 aws:PrincipalOrgID 全局条件键检查组织 ID 值。

{ "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "*" }, "Action": "SNS:Publish", "Resource": "arn:aws:sns:us-east-2:444455556666:MyTopic", "Condition": { "StringEquals": { "aws:PrincipalOrgID": "myOrgId" } } } ] }

允许任何 CloudWatch 警报发布到其他账户中的主题

在这种情况下,帐户中的任何 CloudWatch 都会发出警报111122223333允许向账户中的 Amazon SNS 主题发布消息444455556666.

{ "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "*" }, "Action": "SNS:Publish", "Resource": "arn:aws:sns:us-east-2:444455556666:MyTopic", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:cloudwatch:us-east-2:111122223333:alarm:*" } } } ] }

仅限从特定 VPC 终端节点发布到 Amazon SNS 主题

在这种情况下,账户 444455556666 中的主题只允许从具有 ID 的 VPC 终端节点发布vpce-1ab2c34d.

{ "Statement": [{ "Effect": "Deny", "Principal": "*", "Action": "SNS:Publish", "Resource": "arn:aws:sns:us-east-2:444455556666:MyTopic", "Condition": { "StringNotEquals": { "aws:sourceVpce": "vpce-1ab2c34d" } } }] }