Amazon Cognito 如何与 IAM 配合使用 - Amazon Cognito
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

Amazon Cognito 如何与 IAM 配合使用

在使用 IAM 管理对 Cognito 的访问权限之前,请了解可以将哪些 IAM 功能用于 Cognito。

您可以与 Amazon Cognito 一起使用的 IAM 功能
IAM 功能 Cognito 支持

基于身份的策略

基于资源的策略

策略操作

策略资源

策略条件键

ACL

ABAC(策略中的标签)

部分

临时凭证

委托人权限

服务角色

服务相关角色

要获取 Cognito 和其他概要视图Amazon服务与大多数 IAM 功能配合使用,请参阅Amazon使用 IAM 的服务中的IAM 用户指南

Cognito 的基于身份的策略

支持基于身份的策略

基于身份的策略是可附加到身份(如 IAM 用户、用户组或角色)的 JSON 权限策略文档。这些策略控制用户和角色可在何种条件下对哪些资源执行哪些操作。要了解如何创建基于身份的策略,请参阅。创建 IAM 策略中的IAM 用户指南

通过使用 IAM 基于身份的策略,您可以指定允许或拒绝的操作和资源以及允许或拒绝操作的条件。您无法在基于身份的策略中指定委托人,因为它适用于其附加到的用户或角色。要了解您可以在 JSON 策略中使用的所有元素,请参阅IAM JSON 策略元素参考中的IAM 用户指南

Cognito 的基于身份的策略示例

要查看 Cognito 基于身份的策略的示例,请参阅。Amazon Cognito 的基于身份的策略示例

Cognito 内基于资源的策略

支持基于资源的策略

基于资源的策略是附加到资源的 JSON 策略文档。基于资源的策略的示例包括 IAM 角色信任策略 和 Amazon S3 存储桶策略。在支持基于资源的策略的服务中,服务管理员可以使用它们来控制对特定资源的访问。对于在其中附加策略的资源,策略定义指定委托人可以对该资源执行哪些操作以及在什么条件下执行。您必须在基于资源的策略中指定委托人。委托人可以包括账户、用户、角色、联合身份用户或 Amazon 服务。

要启用跨账户访问,您可以将整个账户或其他账户中的 IAM 实体指定为基于资源的策略中的委托人。将跨账户委托人添加到基于资源的策略只是建立信任关系工作的一半而已。当委托人和资源处于不同的Amazon账户,则受信任账户中的 IAM 管理员还必须授予委托人实体(用户或角色)访问资源的权限。他们通过将基于身份的策略附加到实体以授予权限。但是,如果基于资源的策略向同一个账户中的委托人授予访问权限,则不需要额外的基于身份的策略。有关更多信息,请参阅 。IAM 角色与基于资源的策略的区别中的IAM 用户指南

Cognito 的策略操作

支持策略操作

管理员可以使用 Amazon JSON 策略来指定谁有权访问什么内容。也就是说,这委托人可以执行操作上的什么resources,并根据什么条件

JSON 策略的 Action 元素描述可用于在策略中允许或拒绝访问的操作。策略操作通常与关联的 Amazon API 操作同名。有一些例外情况,例如没有匹配 API 操作的仅限权限 操作。还有一些操作要求在策略中执行多个操作。这些附加操作称为相关操作

在策略中包含操作以授予执行相关操作的权限。

要查看 Cognito 操作的列表,请参阅Amazon Cognito 定义的操作中的服务授权参考

Cognito 中的策略操作在操作前使用以下前缀::

cognito-identity

要在单个语句中指定多项操作,请使用逗号将它们隔开。

"Action": [ "cognito-identity:action1", "cognito-identity:action2" ]

签名与未签名的 API

签名的 APIAmazon凭证能够通过 IAM 策略进行限制。以下 Cognito API 未签名,因此无法通过 IAM 策略进行限制:

Amazon Cognito Federated 身份

  • GetId

  • GetOpenIdToken

  • GetCredentialsForIdentity

  • UnlinkIdentity

Amazon Cognito 您的用户池

  • ChangePassword

  • ConfirmDevice

  • ConfirmForgotPassword

  • ConfirmSignUp

  • DeleteUser

  • DeleteUserAttributes

  • ForgetDevice

  • ForgotPassword

  • GetDevice

  • GetUser

  • GetUserAttributeVerificationCode

  • GlobalSignOut

  • InitiateAuth

  • ListDevices

  • ResendConfirmationCode

  • RespondToAuthChallenge

  • SetUserSettings

  • SignUp

  • UpdateDeviceStatus

  • UpdateUserAttributes

  • VerifyUserAttribute

要查看 Cognito 基于身份的策略的示例,请参阅。Amazon Cognito 的基于身份的策略示例

Cognito 的策略资源

支持策略资源

管理员可以使用 Amazon JSON 策略来指定谁有权访问什么内容。也就是说,这委托人可以执行操作上的什么resources,并根据什么条件

Resource JSON 策略元素指定要向其应用操作的一个或多个对象。语句必须包含 ResourceNotResource 元素。作为最佳实践,请使用其 Amazon 资源名称 (ARN)指定资源。对于支持特定资源类型(称为资源级权限)的操作,您可以执行此操作。

对于不支持资源级权限的操作(如列出操作),请使用通配符 (*) 指示语句应用于所有资源。

"Resource": "*"

Amazon 资源名称 (ARN)

适用于 Amazon Cognito 联合身份的 ARN

在 Amazon Cognito 身份池(联合身份)中,您可以使用如下例所示的 Amazon 资源名称 (ARN) 格式限制 IAM 用户对特定身份池的访问权限。有关 ARN 的更多信息,请参阅 IAM 标识符

arn:aws:cognito-identity:REGION:ACCOUNT_ID:identitypool/IDENTITY_POOL_ID

Amazon Cognito Sync 的 ARN

在 Amazon Cognito Sync 中,客户还可以按身份池 ID、身份 ID 和数据集名称限制访问。

对于在身份池上运行的 API,身份池 ARN 格式与 Amazon Cognito 联合身份的相同,但前者的服务名称是cognito-sync而不是cognito-identity

arn:aws:cognito-sync:REGION:ACCOUNT_ID:identitypool/IDENTITY_POOL_ID

对于在单个身份池上运行的 API (例如 RegisterDevice),您可以通过以下 ARN 格式引用单个身份:

arn:aws:cognito-sync:REGION:ACCOUNT_ID:identitypool/IDENTITY_POOL_ID/identity/IDENTITY_ID

有关在数据集上运行的 API (例如 UpdateRecordsListRecords),您可以使用以下 ARN 格式引用单个数据集:

arn:aws:cognito-sync:REGION:ACCOUNT_ID:identitypool/IDENTITY_POOL_ID/identity/IDENTITY_ID/dataset/DATASET_NAME

适用于 Amazon Cognito 您的用户池的 ARN

对于 Amazon Cognito 您的用户池,您可以使用以下 ARN 格式限制 IAM 用户对特定用户池的访问权限:

arn:aws:cognito-idp:REGION:ACCOUNT_ID:userpool/USER_POOL_ID

要查看 Cognito 资源类型及其 ARN 的列表,请参阅。Amazon Cognito 定义的资源中的服务授权参考。要了解您可以对哪些操作指定每个资源的 ARN,请参阅Amazon Cognito 定义的操作

要查看 Cognito 基于身份的策略的示例,请参阅。Amazon Cognito 的基于身份的策略示例

Cognito 的策略条件密钥

支持策略条件密钥

管理员可以使用 Amazon JSON 策略来指定谁有权访问什么内容。也就是说,这委托人可以执行操作上的什么resources,并根据什么条件

Condition 元素(或 Condition )中,可以指定语句生效的条件。Condition 元素是可选的。您可以创建使用条件运算符(例如,等于或小于)的条件表达式,以使策略中的条件与请求中的值相匹配。

如果您在一个语句中指定多个 Condition 元素,或在单个 Condition 元素中指定多个键,则 Amazon 使用逻辑 AND 运算评估。如果您为单个条件键指定多个值,则 Amazon 使用逻辑 OR 运算来评估条件。在授予语句的权限之前必须满足所有的条件。

在指定条件时,您也可以使用占位符变量。例如,只有在使用 IAM 用户名标记 IAM 用户时,您才能为其授予访问资源的权限。有关更多信息,请参阅 。IAM 策略元素:变量和标签中的IAM 用户指南

Amazon 支持全局条件键和特定于服务的条件键。要查看所有 Amazon 全局条件键,请参阅 IAM 用户指南中的 Amazon 全局条件上下文键。

要查看 Cognito 条件键的列表,请参阅Amazon Cognito 的状况键中的服务授权参考。要了解您可以对哪些操作和资源使用条件键,请参阅Amazon Cognito 定义的操作

要查看 Cognito 基于身份的策略的示例,请参阅。Amazon Cognito 的基于身份的策略示例

Cognito 中的访问控制列表 (ACL)

支持 ACL

访问控制列表 (ACL) 控制哪些委托人(账户成员、用户或角色)有权访问资源。ACL 与基于资源的策略类似,尽管它们不使用 JSON 策略文档格式。

使用 Cognito 的基于属性的访问控制 (ABAC)

支持 ABAC(策略中的标签)

部分

基于属性的访问控制 (ABAC) 是一种授权策略,该策略基于属性来定义权限。在 Amazon 中,这些属性称为标签。您可以将标签附加到 IAM 实体(用户或角色)以及许多Amazon资源的费用。ABAC 的第一步是标记实体和资源。然后,您可以设计 ABAC 策略,以允许在委托人的标签与他们试图访问的资源上的标签匹配时执行操作。

ABAC 在快速增长的环境中非常有用,并在策略管理变得繁琐的情况下可以提供帮助。

要基于标签控制访问,您需要使用 aws:ResourceTag/key-nameaws:RequestTag/key-nameaws:TagKeys 条件键在策略的条件元素中提供标签信息。

有关 ABAC 的更多信息,请参阅什么是 ABAC?中的IAM 用户指南。要查看包含设置 ABAC 步骤的教程,请参阅使用基于属性的访问控制 (ABAC)中的IAM 用户指南

将临时证书与 Cognito 一起使用

支持临时凭证

一段时间Amazon服务在您使用临时证书登录时无法正常工作。有关其他信息,包括哪些Amazon服务与临时证书配合使用,请参阅Amazon使用 IAM 的服务中的IAM 用户指南

您正在使用临时证书,如果您登录到Amazon Web Services Management Console使用除了用户名和密码之外的任何方法。例如,当您访问Amazon使用您公司的单点登录 (SSO) 链接,则该过程会自动创建临时凭证。当您以用户身份登录控制台,然后切换角色时,您还会自动创建临时凭证。有关切换角色的更多信息,请参阅切换为角色(控制台)中的IAM 用户指南

您可以使用Amazon CLI或者AmazonAPI。之后,您可使用这些临时凭证访问Amazon。Amazon建议您动态生成临时证书,而不是使用长期访问密钥。有关更多信息,请参阅 。IAM 中的临时安全凭证

Cognito 的跨服务主体权限

支持委托人权限

当您使用 IAM 用户或角色在Amazon,您将被视为一个委托人。策略向委托人授予权限。使用某些服务时,您可能会执行一个操作,此操作然后在不同服务中触发另一个操作。在这种情况下,您必须具有执行这两个操作的权限。要查看某个操作是否需要策略中的其他相关操作,请参阅Amazon Cognito 的操作、资源和条件键中的服务授权参考

Cognito 的服务角色

支持服务角色

服务角色是IAM 角色服务假定代表您执行操作的操作。服务角色只在您的账户内提供访问权限,不能用于为访问其他账户中的服务授权。IAM 管理员可以在 IAM 中创建、修改和删除服务角色。有关更多信息,请参阅 IAM 用户指南中的创建向Amazon服务委派权限的角色

有关 Cognito 服务角色的详细信息,请参阅启用推送同步推送同步

警告

更改服务角色的权限可能会破坏 Cognito 功能。仅当 Cognito 提供相关指导时才编辑服务角色。

Cognito 的服务相关角色

支持服务相关角色

服务相关角色是一种服务角色,链接到Amazon服务。服务可以代入代表您执行操作的角色。服务相关角色显示在您的 IAM 账户中,并归该服务所有。IAM 管理员可以查看但不能编辑服务相关角色的权限。

有关创建或管理 Cognito 服务相关角色的详细信息,请参阅对 Amazon Cognito 使用服务相关角色