亚马逊 Cognito 是如何使用的 IAM - Amazon Cognito

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

亚马逊 Cognito 是如何使用的 IAM

在使用管理IAM对亚马逊 Cognito 的访问权限之前,请先了解亚马逊 Cognito 有哪些IAM功能可供使用。

IAM你可以在 Amazon Cognito 上使用的功能
IAM功能 Amazon Cognito 支持

基于身份的策略

基于资源的策略

策略操作

策略资源

策略条件键

ACLs

ABAC(策略中的标签)

部分

临时凭证

主体权限

服务角色

服务相关角色

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

Amazon Cognito 基于身份的策略

支持基于身份的策略:

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

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

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

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

Amazon Cognito 内基于资源的策略

支持基于资源的策略:

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

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

Amazon Cognito 的策略操作

支持策略操作:

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

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

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

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

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

cognito-identity

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

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

已签名与未签名 APIs

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

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

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

亚马逊 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 的策略资源

支持策略资源:

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

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

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

"Resource": "*"

亚马逊资源名称 (ARNs)

ARNs适用于 Amazon Cognito 联合身份

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

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

ARNs适用于亚马逊 Cognito Sync

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

对于在身份池上进行操作APIs,身份池ARN格式与 Amazon Cognito Federated Identients 的格式相同,唯一的不同是服务名称cognito-sync取代了:cognito-identity

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

为APIs此,可以对单个身份进行操作RegisterDevice,例如,您可以通过以下ARN格式引用个人身份:

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

为APIs此,可以对数据集(例如UpdateRecords和)进行操作ListRecords,您可以使用以下ARN格式引用各个数据集:

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

ARNs适用于 Amazon Cognito 用户池

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

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

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

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

Amazon Cognito 的策略条件键

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

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

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

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

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

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

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

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

亚马逊 Cognito 中的访问控制列表 (ACLs)

支持ACLs:

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

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

支持ABAC(策略中的标签):部分

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

ABAC在快速增长的环境中很有用,也有助于解决策略管理变得繁琐的情况。

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

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

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

将临时凭证用于 Amazon Cognito

支持临时凭证:

当你使用临时证书登录时,有些 AWS 服务 不起作用。有关其他信息,包括哪些 AWS 服务 适用于临时证书 AWS 服务 ,请参阅《IAM用户指南》IAM中的 “适用于临时证书”。

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

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

Amazon Cognito 的跨服务主体权限

支持转发访问会话 (FAS):

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

Amazon Cognito 的服务角色

支持服务角色:

服务IAM角色是服务代替您执行操作的角色。IAM管理员可以在内部创建、修改和删除服务角色IAM。有关更多信息,请参阅《IAM用户指南》 AWS 服务中的创建角色以向委派权限

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

警告

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

Amazon Cognito 的服务相关角色

支持服务相关角色:

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

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