本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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)
+ [Amazon Kendra 資源型政策](#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 使用者指南*中的 [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)。

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

管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說，哪個**主體**在什麼**條件**下可以對什麼**資源**執行哪些**動作**。

`Resource` JSON 政策元素可指定要套用動作的物件。最佳實務是使用其 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 來指定資源。若動作不支援資源層級許可，使用萬用字元 (\*) 表示該陳述式適用於所有資源。

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





Amazon Kendra 索引資源具有下列 ARN：

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

如需 ARNs 格式的詳細資訊，請參閱 [Amazon Resource Name (ARNs) 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 資源類型及其 ARNs 的清單，請參閱《*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 身分型政策的範例，請參閱 [Amazon Kendra 身分型政策範例](security_iam_id-based-policy-examples.md)。

## Amazon Kendra 資源型政策
<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 服務和資源的存取控制清單 (ACLs)。

## 以 Amazon Kendra 標籤為基礎的授權
<a name="security_iam_service-with-iam-tags"></a>

您可以將標籤與特定類型的 Amazon Kendra 資源建立關聯，以授權存取這些資源。若要根據標籤控制存取，請使用 `aws:RequestTag/{{key-name}}`、 或 條件索引鍵，在政策的條件元素中提供`aws:TagKeys`標籤資訊。

下表列出了標籤存取控制的動作、對應資源類型及條件索引鍵。每個動作都會根據與對應資源類型相關聯的標籤進行授權。


| Action | Resource Type (資源類型) | 條件索引鍵 | 
| --- | --- | --- | 
|  [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 資源的詳細資訊，請參閱 [Tags (標籤)](tagging.md)。如需根據資源標籤限制資源存取的身分型政策範例，請參閱 [標籤型政策範例](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>

[IAM 角色](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) 或 [GetFederationToken](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetFederationToken.html) 等 AWS STS API 操作來取得臨時安全登入資料。

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 Kendra 用來代表您存取必要資源的存取角色 Amazon Resource Name (ARN)。如果您先前已建立角色，則 Amazon Kendra 主控台會為您提供可供選擇的角色清單。請務必選擇允許存取您所需資源的角色。如需詳細資訊，請參閱[IAM 適用於 Amazon Kendra的 存取角色](iam-roles.md)。