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

# Amazon Kendra 如何与 IAM 协同工作
<a name="security_iam_service-with-iam"></a>

在使用 IAM 管理对 Amazon Kendra 的访问权限之前，您应该了解哪些 IAM 功能可用于 Amazon Kendra。要全面了解 Amazon Kendra 和其他 AWS 服务如何与 IAM 配合使用，请参阅 IAM *用户指南中的与 IAM 配合使用的AWS *[服务](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。

**Topics**
+ [Amazon Kendra 基于身份的策略](#security_iam_service-with-iam-id-based-policies)
+ [亚马逊 Kendra 政策 Resource-based](#security_iam_service-with-iam-resource-based-policies)
+ [访问控制列表（ACL）](#security_iam_service-with-iam-acls)
+ [基于 Amazon Kendra 标签的授权](#security_iam_service-with-iam-tags)
+ [Amazon Kendra IAM 角色](#security_iam_service-with-iam-roles)

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

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

### 操作
<a name="security_iam_service-with-iam-id-based-policies-actions"></a>

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

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

Amazon Kendra 中的策略操作在操作前面使用以下前缀：`kendra:`。例如，要授予某人[ListIndices](https://docs.aws.amazon.com/kendra/latest/dg/API_ListIndices.html)通过 API 操作列出 Amazon Kendra 索引的权限，您需要将该`kendra:ListIndices`操作包含在他们的策略中。策略语句必须包含 `Action` 或 `NotAction` 元素。Amazon Kendra 定义了一组自己的操作，以描述您可以使用该服务执行的任务。

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

```
"Action": [
      "kendra:action1",
      "kendra:action2"
```

您也可以使用通配符 （\*) 指定多个操作。例如，要指定以单词 `Describe` 开头的所有操作，包括以下操作：

```
"Action": "kendra:Describe*"
```

要查看 Amazon Kendra 操作的列表，请参阅《IAM 用户指南》**中的 [Amazon Kendra 定义的操作](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_kendra.html#kendra-actions-as-permissions)。

### 资源
<a name="security_iam_service-with-iam-id-based-policies-resources"></a>

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

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

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





Amazon Kendra 索引资源具有以下 ARN：

```
arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}
```

有关 ARN 格式的更多信息，请参阅 A [mazon 资源名称 (ARN) 和 AWS 服务](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)命名空间。

例如，要在语句中指定索引，请使用以下 ARN 中索引的 GUID：

```
"Resource": "arn:aws:kendra:${Region}:${Account}:index/${GUID}"
```

要指定属于特定账户的所有索引，请使用通配符（\*）：

```
"Resource": "arn:aws:${Region}:${Account}:index/*"
```

无法对特定资源执行某些 Amazon Kendra 操作，例如，用于创建资源的操作。在这些情况下，您必须使用通配符（\*)。

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

要查看 Amazon Kendra 资源类型及其 ARN 的列表，请参阅《IAM 用户指南》**中的 [Amazon Kendra 定义的资源](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_kendra.html#kendra-resources-for-iam-policies)。要了解您可以使用哪些操作指定每个资源的 ARN，请参阅 [Amazon Kendra 定义的操作](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_kendra.html#kendra-actions-as-permissions)。

### 条件键
<a name="security_iam_service-with-iam-id-based-policies-conditionkeys"></a>

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

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

Amazon Kendra 不提供任何特定于服务的条件键，但支持使用某些全局条件键。要查看所有 AWS 全局条件键，请参阅 *IAM 用户指南*中的[AWS 全局条件上下文密钥](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html)。

### 示例
<a name="security_iam_service-with-iam-id-based-policies-examples"></a>



要查看 Amazon Kendra 基于身份的策略的示例，请参阅[亚马逊 Kendra 政策示例 Identity-based](security_iam_id-based-policy-examples.md)。

## 亚马逊 Kendra 政策 Resource-based
<a name="security_iam_service-with-iam-resource-based-policies"></a>

Amazon Kendra 不支持基于资源的策略。

## 访问控制列表（ACL）
<a name="security_iam_service-with-iam-acls"></a>

Amazon Kendra 不支持访问 AWS 服务和资源的访问控制列表（ACL）。

## 基于 Amazon Kendra 标签的授权
<a name="security_iam_service-with-iam-tags"></a>

您可以将标签与某些类型的 Amazon Kendra 资源关联以授权访问这些资源。要基于标签控制访问，请使用 `aws:RequestTag/{{key-name}}` 或 `aws:TagKeys` 条件键在策略的条件元素中提供标签信息。

下表列出了基于标签的访问控制的操作、相应的资源类型和条件键。根据与相应资源类型关联的标签对每个操作进行授权。


| 处理建议 | 资源类型 | 条件键 | 
| --- | --- | --- | 
|  [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)  |   | aws:RequestTag, aws:TagKeys | 
| [CreateFaq](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateFaq.html) |   | aws:RequestTag, aws:TagKeys | 
|  [CreateIndex](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateIndex.html)  |   | aws:RequestTag, aws:TagKeys | 
|  [API\_ ListTagsForResource](https://docs.aws.amazon.com/kendra/latest/dg/API_ListTagsForResource.html)  | 数据来源、常见问题、索引 |   | 
| [TagResource](https://docs.aws.amazon.com/kendra/latest/dg/API_TagResource.html)  | 数据来源、常见问题、索引 | aws:RequestTag, aws:TagKeys | 
| [UntagResource](https://docs.aws.amazon.com/kendra/latest/dg/API_UntagResource.html)  | 数据来源、常见问题、索引 | aws:TagKeys | 

有关标记 Amazon Kendra 资源的信息，请参阅[标签](tagging.md)。有关基于资源标签限制对资源的访问的基于身份的策略示例，请参阅[Tag-based 策略示例](security_iam_id-based-policy-examples.md#examples-tagging)。有关使用标签限制对资源的访问的信息，请参阅《IAM 用户指南》中的[使用标签控制访问](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)。**

## Amazon Kendra IAM 角色
<a name="security_iam_service-with-iam-roles"></a>

I [AM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)是您的 AWS 账户中具有特定权限的实体。

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

可以使用临时凭证进行联合身份验证登录，分派 IAM 角色或分派跨账户角色。您可以通过调用[AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)或之类的 AWS STS API 操作来获取临时安全证书[GetFederationToken](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetFederationToken.html)。

Amazon Kendra 支持使用临时凭证。

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

此功能允许服务代表您担任[服务角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role)。此角色允许服务访问其他服务中的资源以代表您完成操作。服务角色显示在 IAM 账户中，并归该账户所有。这意味着，IAM 管理员可以更改该角色的权限。但是，这样做可能会中断服务的功能。

Amazon Kendra 支持服务角色。

### 在 Amazon Kendra 中选择 IAM 角色
<a name="security_iam_service-with-iam-roles-choose"></a>

在创建索引、调用 `BatchPutDocument` 操作、创建数据来源或创建常见问题解答时，必须提供访问角色 Amazon 资源名称（ARN），Amazon Kendra 使用该角色代表您访问所需资源。如果您之前创建了一个角色，Amazon Kendra 控制台会为您提供一个角色列表供您选择。选择允许访问所需资源的角色非常重要。有关更多信息，请参阅 [IAM 适用于 Amazon Kendra的 访问角色](iam-roles.md)。