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

# Amazon Cognito 如何与 IAM 配合使用
<a name="security_iam_service-with-iam"></a>

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






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

| IAM 功能 | Amazon Cognito 支持 | 
| --- | --- | 
|  [基于身份的策略](#security_iam_service-with-iam-id-based-policies)  |   是  | 
|  [基于资源的策略](#security_iam_service-with-iam-resource-based-policies)  |   否   | 
|  [策略操作](#security_iam_service-with-iam-id-based-policies-actions)  |   是  | 
|  [策略资源](#security_iam_service-with-iam-id-based-policies-resources)  |   是  | 
|  [策略条件键](#security_iam_service-with-iam-id-based-policies-conditionkeys)  |   是  | 
|  [ACLs](#security_iam_service-with-iam-acls)  |   否   | 
|  [ABAC（策略中的标签）](#security_iam_service-with-iam-tags)  |   部分  | 
|  [临时凭证](#security_iam_service-with-iam-roles-tempcreds)  |   是  | 
|  [主体权限](#security_iam_service-with-iam-principal-permissions)  |   否   | 
|  [服务角色](#security_iam_service-with-iam-roles-service)  |   是  | 
|  [服务关联角色](#security_iam_service-with-iam-roles-service-linked)  |   是  | 

要全面了解 Amazon Cognito 和其他 Amazon 服务如何与大多数 IAM 功能配合使用，请参阅 IAM *用户指南中与 IAM 配合使用的Amazon *[服务](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。

## Amazon Cognito 基于身份的策略
<a name="security_iam_service-with-iam-id-based-policies"></a>

**支持基于身份的策略：**是

基于身份的策略是可附加到身份（如 IAM 用户、用户组或角色）的 JSON 权限策略文档。这些策略控制用户和角色可在何种条件下对哪些资源执行哪些操作。要了解如何创建基于身份的策略，请参阅《IAM 用户指南》**中的[使用客户管理型策略定义自定义 IAM 权限](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies_create.html)。

通过使用 IAM 基于身份的策略，您可以指定允许或拒绝的操作和资源以及允许或拒绝操作的条件。要了解可在 JSON 策略中使用的所有元素，请参阅《IAM 用户指南》**中的 [IAM JSON 策略元素引用](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_elements.html)。

### 适用于 Amazon Cognito 的基于身份的策略示例
<a name="security_iam_service-with-iam-id-based-policies-examples"></a>



要查看 Amazon Cognito 基于身份的策略的示例，请参阅[适用于 Amazon Cognito 的基于身份的策略示例](security_iam_id-based-policy-examples.md)。

## Amazon Cognito 内基于资源的策略
<a name="security_iam_service-with-iam-resource-based-policies"></a>

**支持基于资源的策略：**否 

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

要启用跨账户访问，您可以将整个账户或其他账户中的 IAM 实体指定为基于资源的策略中的主体。有关更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的跨账户资源访问](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html)。

## Amazon Cognito 的策略操作
<a name="security_iam_service-with-iam-id-based-policies-actions"></a>

**支持策略操作：**是

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

JSON 策略的 `Action` 元素描述可用于在策略中允许或拒绝访问的操作。在策略中包含操作以授予执行关联操作的权限。



要查看 Amazon Cognito 操作的列表，请参阅《服务授权参考》**中的 [Amazon Cognito 定义的操作](https://docs.amazonaws.cn/service-authorization/latest/reference/list_amazoncognitoidentity.html#amazoncognitoidentity-actions-as-permissions)。

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

```
cognito-identity
```

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

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

### 已签名与未签名 APIs
<a name="security_amazon-cognito-signed-versus-unsigned-apis"></a>

当您使用 Amazon 证书签署 Amazon Cognito API 请求时，您可以在 Amazon Identity and Access Management (IAM) 策略中对其进行限制。您必须使用 Amazon 凭证签署的 API 请求包括使用 `AdminInitiateAuth` 进行服务器端登录，以及创建、查看或修改您的 Amazon Cognito 资源的操作（如 `UpdateUserPool`）。有关已签名的 API 请求的更多信息，请参阅[签署 Amazon API 请求](https://docs.amazonaws.cn/general/latest/gr/signing_aws_api_requests.html)。

由于 Amazon Cognito 是一款用于您想要向公众开放的应用程序的消费者身份产品，因此您可以访问以下未签名的应用程序。 APIs您的应用程序针对您的用户和潜在用户发出这些 API 请求。有些 APIs 不需要事先授权`InitiateAuth`，例如启动新的身份验证会话。有些人 APIs 使用访问令牌或会话密钥进行授权，例如`VerifySoftwareToken`为现有经过身份验证的会话的用户完成 MFA 设置。未签署但已授权的 Amazon Cognito 用户池 API 支持请求语法中的 `Session` 或 `AccessToken` 参数，如 [Amazon Cognito API 参考](https://docs.amazonaws.cn/cognito-user-identity-pools/latest/APIReference/Welcome.html)中所示。未签署的 Amazon Cognito 身份 API 支持 `IdentityId` 参数，如 [Amazon Cognito 联合身份 API 参考](https://docs.amazonaws.cn/cognitoidentity/latest/APIReference/Welcome.html)中所示。

有关 Amazon Cognito 用户池 API 操作的授权模式和角色的更多信息，请参阅[按授权模型分组的 API 操作列表](authentication-flows-public-server-side.md#user-pool-apis-auth-unauth)。

**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 的基于身份的策略示例](security_iam_id-based-policy-examples.md)。

## Amazon Cognito 的策略资源
<a name="security_iam_service-with-iam-id-based-policies-resources"></a>

**支持策略资源：**是

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

`Resource` JSON 策略元素指定要向其应用操作的一个或多个对象。作为最佳实践，请使用其 [Amazon 资源名称（ARN）](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference-arns.html)指定资源。对于不支持资源级权限的操作，请使用通配符 (\$1) 指示语句应用于所有资源。

```
"Resource": "*"
```

### 亚马逊资源名称 (ARNs)
<a name="security_amazon-cognito-amazon-resource-names"></a>

**ARNs 适用于 Amazon Cognito 联合身份**

在 Amazon Cognito 身份池（联合身份）中，您可以使用如下例所示的 Amazon Resource Name（ARN）格式限制 IAM 用户对特定身份池的访问权限。有关更多信息 ARNs，请参阅 [IAM 标识符](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_identifiers.html)。

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

**ARNs 适用于亚马逊 Cognito Sync**

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

对于在身份池上进行操作 APIs ，身份池 ARN 格式与 Amazon Cognito Federations 的格式相同，唯一的不同是服务名称`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 定义*的*资源](https://docs.amazonaws.cn/service-authorization/latest/reference/list_amazoncognitoidentity.html#amazoncognitoidentity-resources-for-iam-policies)。要了解您可以使用哪些操作指定每个资源的 ARN，请参阅 [Amazon Cognito 定义的操作](https://docs.amazonaws.cn/service-authorization/latest/reference/list_amazoncognitoidentity.html#amazoncognitoidentity-actions-as-permissions)。





要查看 Amazon Cognito 基于身份的策略的示例，请参阅[适用于 Amazon Cognito 的基于身份的策略示例](security_iam_id-based-policy-examples.md)。

## Amazon Cognito 的策略条件键
<a name="security_iam_service-with-iam-id-based-policies-conditionkeys"></a>

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

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

`Condition` 元素根据定义的条件指定语句何时执行。您可以创建使用[条件运算符](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html)（例如，等于或小于）的条件表达式，以使策略中的条件与请求中的值相匹配。要查看所有 Amazon 全局条件键，请参阅 *IAM 用户指南*中的[Amazon 全局条件上下文密钥](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_condition-keys.html)。

有关 Amazon Cognito 条件键的列表，请参阅《服务授权参考》**中的 [Amazon Cognito 的条件键](https://docs.amazonaws.cn/service-authorization/latest/reference/list_amazoncognitoidentity.html#amazoncognitoidentity-policy-keys)。要了解您可以对哪些操作和资源使用条件键，请参阅 [Amazon Cognito 定义的操作](https://docs.amazonaws.cn/service-authorization/latest/reference/list_amazoncognitoidentity.html#amazoncognitoidentity-actions-as-permissions)。

要查看 Amazon Cognito 基于身份的策略的示例，请参阅[适用于 Amazon Cognito 的基于身份的策略示例](security_iam_id-based-policy-examples.md)。

## 亚马逊 Cognito 中的访问控制列表 (ACLs)
<a name="security_iam_service-with-iam-acls"></a>

**支持 ACLs：**否 

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

## 使用 Amazon Cognito 的基于属性的访问权限控制（ABAC）
<a name="security_iam_service-with-iam-tags"></a>

**支持 ABAC（策略中的标签）：**部分支持

基于属性的访问权限控制（ABAC）是一种授权策略，该策略基于称为标签的属性来定义权限。您可以将标签附加到 IAM 实体和 Amazon 资源，然后设计 ABAC 策略以允许在委托人的标签与资源上的标签匹配时进行操作。

要基于标签控制访问，您需要使用 `aws:ResourceTag/key-name``aws:RequestTag/key-name` 或 `aws:TagKeys` 条件键在策略的[条件元素](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_elements_condition.html)中提供标签信息。

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

有关 ABAC 的更多信息，请参阅《IAM 用户指南》**中的[使用 ABAC 授权定义权限](https://docs.amazonaws.cn/IAM/latest/UserGuide/introduction_attribute-based-access-control.html)。要查看设置 ABAC 步骤的教程，请参阅《IAM 用户指南》**中的[使用基于属性的访问权限控制（ABAC）](https://docs.amazonaws.cn/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html)。

## 将临时凭证用于 Amazon Cognito
<a name="security_iam_service-with-iam-roles-tempcreds"></a>

**支持临时凭证：**是

临时证书提供对 Amazon 资源的短期访问权限，并且是在您使用联合身份或切换角色时自动创建的。 Amazon 建议您动态生成临时证书，而不是使用长期访问密钥。有关更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的临时安全凭证](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_credentials_temp.html)和[使用 IAM 的。Amazon Web Services 服务](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)

## Amazon Cognito 的跨服务主体权限
<a name="security_iam_service-with-iam-principal-permissions"></a>

**支持转发访问会话（FAS）：**否 

 转发访问会话 (FAS) 使用调用主体的权限 Amazon Web Services 服务，再加上 Amazon Web Services 服务 向下游服务发出请求的请求。有关发出 FAS 请求时的策略详情，请参阅[转发访问会话](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_forward_access_sessions.html)。

## Amazon Cognito 的服务角色
<a name="security_iam_service-with-iam-roles-service"></a>

**支持服务角色：**是

 服务角色是由一项服务担任、代表您执行操作的 [IAM 角色](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_roles.html)。IAM 管理员可以在 IAM 中创建、修改和删除服务角色。有关更多信息，请参阅《IAM 用户指南》**中的[创建向 Amazon Web Services 服务委派权限的角色](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_roles_create_for-service.html)。

有关 Amazon Cognito 服务角色的详细信息，请参阅[激活推送同步](identity-pools.md#enable-push-synchronization)和[实施推送同步](push-sync.md)。

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

## Amazon Cognito 的服务相关角色
<a name="security_iam_service-with-iam-roles-service-linked"></a>

**支持服务关联角色：**是

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

有关创建或管理 Amazon Cognito 服务相关角色的详细信息，请参阅[对 Amazon Cognito 使用服务相关角色](using-service-linked-roles.md)。