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

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

Amazon Cognito 如何与 IAM 配合使用

在使用 IAM 管理对 Amazon Cognito 的访问权限之前,您应该了解哪些 IAM 功能可用于 Amazon Cognito。

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

基于身份的策略

基于资源的策略

策略操作

策略资源

策略条件键

ACL

ABAC(策略中的标签)

部分

临时凭证

主体权限

服务角色

服务相关角色

要全面了解 Amazon Cognito 和其他 Amazon 服务如何与大多数 IAM 功能配合使用,请参阅 IAM 用户指南中与 IAM 配合使用的Amazon 服务

Amazon Cognito 基于身份的策略

支持基于身份的策略

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

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

适用于 Amazon Cognito 的基于身份的策略示例

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

Amazon Cognito 内基于资源的策略

支持基于资源的策略

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

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

Amazon Cognito 的策略操作

支持策略操作

管理员可以使用 Amazon JSON 策略来指定谁有权访问什么。也就是说,哪个主体 可以对什么资源 执行操作,以及在什么 条件 下执行。

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

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

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

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

cognito-identity

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

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

签名与未签名的 API

当您使用 Amazon 证书签署 Amazon Cognito API 请求时,您可以在 Amazon Identity and Access Management (IAM) 策略中对其进行限制。您必须使用 Amazon 凭证签署的 API 请求包括使用 AdminInitiateAuth 进行服务器端登录,以及创建、查看或修改您的 Amazon Cognito 资源的操作(如 UpdateUserPool)。有关已签名的 API 请求的更多信息,请参阅签署 Amazon API 请求

由于 Amazon Cognito 是一款消费者身份产品,适用于您想要向公众开放的应用程序,因此您可以访问以下未签署的 API。您的应用程序针对您的用户和潜在用户发出这些 API 请求。有些 API 不需要事先授权,例如 InitiateAuth 可用于启动新的身份验证会话。有些 API 使用访问令牌或会话密钥进行授权,例如 VerifySoftwareToken 可为已有经过身份验证的会话的用户完成 MFA 设置。未签署但已授权的 Amazon Cognito 用户池 API 支持请求语法中的 SessionAccessToken 参数,如 Amazon Cognito API 参考中所示。未签署的 Amazon Cognito 身份 API 支持 IdentityId 参数,如 Amazon Cognito 联合身份 API 参考中所示。

有关 Amazon Cognito 用户池 API 操作的授权模式和角色的更多信息,请参阅Amazon Cognito 用户池经过身份验证和未经身份验证的 API 操作

Amazon Cognito 身份池 API 操作
  • GetId

  • GetOpenIdToken

  • GetCredentialsForIdentity

  • UnlinkIdentity

Amazon Cognito 用户池 API 操作
  • AssociateSoftwareToken

  • ChangePassword

  • ConfirmDevice

  • ConfirmForgotPassword

  • ConfirmSignUp

  • DeleteUser

  • DeleteUserAttributes

  • ForgetDevice

  • ForgotPassword

  • GetDevice

  • GetUser

  • GetUserAttributeVerificationCode

  • GlobalSignOut

  • InitiateAuth

  • ListDevices

  • ResendConfirmationCode

  • RespondToAuthChallenge

  • RevokeToken

  • SetUserMFAPreference

  • SetUserSettings

  • SignUp

  • UpdateAuthEventFeedback

  • UpdateDeviceStatus

  • UpdateUserAttributes

  • VerifySoftwareToken

  • VerifyUserAttribute

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

Amazon Cognito 的策略资源

支持策略资源

管理员可以使用 Amazon JSON 策略来指定谁有权访问什么。也就是说,哪个主体 可以对什么资源 执行操作,以及在什么条件 下执行。

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

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

"Resource": "*"

Amazon 资源名称(ARN)

适用于 Amazon Cognito 联合身份的 ARN

在 Amazon Cognito 身份池(联合身份)中,您可以使用如下例所示的 Amazon Resource Name(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 格式限制用户对特定用户池的访问权限:

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

有关 Amazon Cognito 资源类型及其 ARN 的列表,请参阅《服务授权引用》中的 Amazon Cognito 定义的资源。要了解您可以使用哪些操作指定每个资源的 ARN,请参阅 Amazon Cognito 定义的操作

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

Amazon Cognito 的策略条件键

支持特定于服务的策略条件键

管理员可以使用 Amazon JSON 策略来指定谁有权访问什么。也就是说,哪个主体可以对什么资源执行操作,以及在什么条件下执行。

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

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

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

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

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

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

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

支持 ACL

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

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

支持 ABAC(策略中的标签)

部分

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

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

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

如果某个服务对于每种资源类型都支持所有这三个条件键,则对于该服务,该值为。如果某个服务仅对于部分资源类型支持所有这三个条件键,则该值为部分

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

将临时凭证用于 Amazon Cognito

支持临时凭证

当你使用临时证书登录时,有些 Amazon Web Services 不起作用。有关更多信息,包括哪些 Amazon Web Services 适用于临时证书,请参阅 IAM 用户指南中的Amazon Web Services 与 IA M 配合使用的信息。

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

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

Amazon Cognito 的跨服务主体权限

支持转发访问会话(FAS)

当您使用 IAM 用户或角色在中执行操作时 Amazon,您被视为委托人。使用某些服务时,您可能会执行一个操作,然后此操作在其他服务中启动另一个操作。FAS 使用调用委托人的权限以及 Amazon Web Service 向下游服务发出请求的请求。 Amazon Web Service只有当服务收到需要与其他 Amazon Web Services 或资源交互才能完成的请求时,才会发出 FAS 请求。在这种情况下,您必须具有执行这两个操作的权限。有关发出 FAS 请求时的策略详情,请参阅转发访问会话

Amazon Cognito 的服务角色

支持服务角色

服务角色是由一项服务担任、代表您执行操作的 IAM 角色。IAM 管理员可以在 IAM 中创建、修改和删除服务角色。有关更多信息,请参阅《IAM 用户指南》中的创建向 Amazon Web Service委派权限的角色

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

警告

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

Amazon Cognito 的服务相关角色

支持服务相关角色

服务相关角色是一种与服务相关联的 Amazon Web Service服务角色。服务可以代入代表您执行操作的角色。服务相关角色出现在您的中 Amazon Web Services 账户 ,并且归服务所有。IAM 管理员可以查看但不能编辑服务相关角色的权限。

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