本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Amazon Lex V2 的身分和存取管理
AWS Identity and Access Management (IAM) 是 AWS 服務 ，可協助管理員安全地控制對 AWS 資源的存取。IAM 管理員可控制誰可以*進行身分驗證* （登入） 和*授權* （具有許可） 來使用 Amazon Lex V2 資源。IAM 是您可以免費使用 AWS 服務 的 。
**Topics**
+ [目標對象](#security_iam_audience)
+ [使用身分驗證](#security_iam_authentication)
+ [使用政策管理存取權](#security_iam_access-manage)
+ [Amazon Lex V2 如何與 IAM 搭配使用](security_iam_service-with-iam.md)
+ [Amazon Lex V2 的身分型政策範例](security_iam_id-based-policy-examples.md)
+ [Amazon Lex V2 的資源型政策範例](security_iam_resource-based-policy-examples.md)
+ [Amazon Lex V2 的 AWS 受管政策](security-iam-awsmanpol.md)
+ [使用 Amazon Lex V2 的服務連結角色](using-service-linked-roles.md)
+ [對 Amazon Lex V2 身分和存取進行故障診斷](security_iam_troubleshoot.md)
## 目標對象
您使用 AWS Identity and Access Management (IAM) 的方式會根據您的角色而有所不同：
+ **服務使用者** — 若無法存取某些功能，請向管理員申請所需許可 (請參閱 [對 Amazon Lex V2 身分和存取進行故障診斷](security_iam_troubleshoot.md))
+ **服務管理員** — 負責設定使用者存取權並提交相關許可請求 (請參閱 [Amazon Lex V2 如何與 IAM 搭配使用](security_iam_service-with-iam.md))
+ **IAM 管理員** — 撰寫政策以管理存取控制 (請參閱 [Amazon Lex V2 的身分型政策範例](security_iam_id-based-policy-examples.md))
## 使用身分驗證
身分驗證是使用身分憑證登入 AWS 的方式。您必須以 AWS 帳戶根使用者、IAM 使用者或擔任 IAM 角色身分進行身分驗證。
您可以使用身分來源的登入資料，例如 AWS IAM Identity Center (IAM Identity Center)、單一登入身分驗證或 Google/Facebook 登入資料，以聯合身分的形式登入。如需有關登入的詳細資訊，請參閱《AWS 登入 使用者指南》**中的[如何登入您的 AWS 帳戶](https://docs.aws.amazon.com/signin/latest/userguide/how-to-sign-in.html)。
對於程式設計存取，AWS 提供 SDK 和 CLI 以密碼編譯方式簽署請求。如需詳細資訊，請參閱《*IAM 使用者指南*》中的適用於 [API 請求的 AWS Signature 第 4 版](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)。
### AWS 帳戶 根使用者
當您建立 時 AWS 帳戶，您會從一個名為 AWS 帳戶 *theroot 使用者的*登入身分開始，該身分具有對所有 AWS 服務 和資源的完整存取權。強烈建議不要使用根使用者來執行日常任務。有關需要根使用者憑證的任務，請參閱《IAM 使用者指南》**中的[需要根使用者憑證的任務](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks)。
### 聯合身分
最佳實務是要求人類使用者使用聯合身分提供者，以 AWS 服務 使用臨時憑證存取 。
*聯合身分*是來自您企業目錄、Web 身分提供者的使用者，或使用來自身分來源的 AWS 服務 憑證存取 Directory Service 的使用者。聯合身分會擔任角色，而該角色會提供臨時憑證。
若需集中化管理存取權限，建議使用 AWS IAM Identity Center。如需詳細資訊，請參閱 *AWS IAM Identity Center 使用者指南*中的[什麼是 IAM Identity Center？](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html)。
### IAM 使用者和群組
*IAM 使用者*[https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users.html)是一種身分具備單人或應用程式的特定許可權。建議以臨時憑證取代具備長期憑證的 IAM 使用者。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[要求人類使用者使用聯合身分提供者來使用臨時憑證存取 AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp)。
[IAM 群組](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups.html)**會指定 IAM 使用者集合，使管理大量使用者的許可權更加輕鬆。如需詳細資訊，請參閱《IAM 使用者指南》**中的 [IAM 使用者的使用案例](https://docs.aws.amazon.com/IAM/latest/UserGuide/gs-identities-iam-users.html)。
### IAM 角色
*IAM 角色*[https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)的身分具有特定許可權，其可以提供臨時憑證。您可以透過[從使用者切換至 IAM 角色 （主控台） ](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-console.html)或呼叫 AWS CLI 或 AWS API 操作來擔任角色。如需詳細資訊，請參閱《IAM 使用者指南》**中的[擔任角色的方法](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage-assume.html)。
IAM 角色適用於聯合身分使用者存取、臨時 IAM 使用者許可、跨帳戶存取權與跨服務存取，以及在 Amazon EC2 執行的應用程式。如需詳細資訊，請參閱《*IAM 使用者指南*》中的 [IAM 中的快帳戶資源存取](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html)。
## 使用政策管理存取權
您可以透過建立政策並將其連接到 AWS 身分或資源來控制 AWS 中的存取。政策定義與身分或資源相關聯的許可。當委託人提出請求時，AWS 會評估這些政策。大部分政策以 JSON 文件形式存放在 AWS 中。如需進一步了解 JSON 政策文件，請參閱《*IAM 使用者指南*》中的 [JSON 政策概觀](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#access_policies-json)。
管理員會使用政策，透過定義哪些**主體**可在哪些**條件**下對哪些**資源**執行**動作**，以指定可存取的範圍。
預設情況下，使用者和角色沒有許可。IAM 管理員會建立 IAM 政策並將其新增至角色，供使用者後續擔任。IAM 政策定義動作的許可，無論採用何種方式執行。
### 身分型政策
身分型政策是附加至身分 (使用者、使用者群組或角色) 的 JSON 許可政策文件。這類政策控制身分可對哪些資源執行哪些動作，以及適用的條件。如需了解如何建立身分型政策，請參閱《*IAM 使用者指南*》中的[透過客戶管理政策定義自訂 IAM 許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)。
身分型政策可分為*內嵌政策* (直接內嵌於單一身分) 與*受管政策* (可附加至多個身分的獨立政策)。如需了解如何在受管政策及內嵌政策之間做選擇，請參閱《IAM 使用者指南》**中的[在受管政策與內嵌政策之間選擇](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-choosing-managed-or-inline.html)。
### 資源型政策
資源型政策是附加到資源的 JSON 政策文件。範例包括 IAM *角色信任政策*與 Amazon S3 *儲存貯體政策*。在支援資源型政策的服務中，服務管理員可以使用它們來控制對特定資源的存取權限。您必須在資源型政策中[指定主體](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html)。
資源型政策是位於該服務中的內嵌政策。您無法在以資源為基礎的原則中使用 IAM 的 AWS 受管原則。
### 其他政策類型
AWS 支援其他政策類型，可設定更多常見政策類型授予的最大許可：
+ **許可界限** — 設定身分型政策可授與 IAM 實體的最大許可。如需詳細資訊，請參閱《 IAM 使用者指南》**中的 [IAM 實體許可界限](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html)。
+ **服務控制政策 (SCP)** — 為 AWS Organizations中的組織或組織單位指定最大許可。如需詳細資訊，請參閱《AWS Organizations 使用者指南》**中的[服務控制政策](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps.html)。
+ **資源控制政策 (RCP)** — 設定您帳戶中資源可用許可的上限。如需詳細資訊，請參閱《AWS Organizations 使用者指南》**中的[資源控制政策 (RCP)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_rcps.html)。
+ **工作階段政策** — 在以程式設計方式為角色或聯合身分使用者建立臨時工作階段時，以參數形式傳遞的進階政策。如需詳細資訊，請參《*IAM 使用者指南*》中的[工作階段政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session)。
### 多種政策類型
當多種類型的政策適用於請求時，產生的許可會更複雜而無法理解。若要了解 AWS 如何決定是否在涉及多種政策類型時允許請求，請參閱《*IAM 使用者指南*》中的[政策評估邏輯](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_evaluation-logic.html)。
# Amazon Lex V2 如何與 IAM 搭配使用
在您使用 IAM 管理 Amazon Lex V2 的存取權之前，請先了解哪些 IAM 功能可與 Amazon Lex V2 搭配使用。
**您可以搭配 Amazon Lex V2 使用的 IAM 功能**
| IAM 功能 | Amazon Lex V2 支援 |
| --- | --- |
| [身分型政策](#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) | *否* |
| [ACL](#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 Lex V2 和其他 AWS 服務如何與大多數 IAM 功能搭配使用，請參閱《*IAM 使用者指南*》中的[可與 IAM 搭配使用的 AWS 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。
## Amazon Lex V2 的身分型政策
**支援以身分為基礎的政策：***是*
身分型政策是可以附加到身分 (例如 IAM 使用者、使用者群組或角色) 的 JSON 許可政策文件。這些政策可控制身分在何種條件下能對哪些資源執行哪些動作。如需了解如何建立身分型政策，請參閱《*IAM 使用者指南*》中的[透過客戶管理政策定義自訂 IAM 許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)。
使用 IAM 身分型政策，您可以指定允許或拒絕的動作和資源，以及在何種條件下允許或拒絕動作。如要了解您在 JSON 政策中使用的所有元素，請參閱《*IAM 使用者指南*》中的 [IAM JSON 政策元素參考](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html)。
### Amazon Lex V2 的身分型政策範例
若要檢視 Amazon Lex V2 身分型政策的範例，請參閱 [Amazon Lex V2 的身分型政策範例](security_iam_id-based-policy-examples.md)。
## Amazon Lex V2 內的資源型政策
**支援以資源為基礎的政策：***是*
資源型政策是附加到資源的 JSON 政策文件。資源型政策的最常見範例是 IAM 角色信任政策和 Amazon S3 儲存貯體政策。在支援資源型政策的服務中，服務管理員可以使用它們來控制對特定資源的存取權限。對於附加政策的資源，政策會定義指定的主體可以對該資源執行的動作以及在何種條件下執行的動作。您必須在資源型政策中[指定主體](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html)。委託人可以包含使用者、角色、聯合身分使用者或 AWS 服務。
您無法搭配 Amazon Lex V2 使用跨帳戶或跨區域政策。如果您為具有跨帳戶或跨區域 ARN 的資源建立政策，Amazon Lex V2 會傳回錯誤。
Amazon Lex V2 服務支援稱為*機器人*政策和*機器人別名*政策的資源型政策，這些政策會連接到機器人或機器人別名。這些政策定義哪些主體可以在機器人或機器人別名上執行動作。
動作只能用於特定資源。例如，`UpdateBot`動作只能用於機器人資源，`UpdateBotAlias`動作只能用於機器人別名資源。如果您在政策中指定無法用於政策中指定資源的動作，Amazon Lex V2 會傳回錯誤。如需動作清單及其可使用的資源，請參閱下表。
| Action | 支援以資源為基礎的政策 | 資源 |
| --- | --- | --- |
| BuildBotLocale | 支援 | BotId |
| CreateBot | 否 | |
| CreateBotAlias | 否 | |
| CreateBotChannel 【僅限許可】 | 支援 | BotId |
| CreateBotLocale | 支援 | BotId |
| CreateBotVersion | 支援 | BotId |
| CreateExport | 支援 | BotId |
| CreateIntent | 支援 | BotId |
| CreateResourcePolicy | 支援 | BotId、BotAliasId |
| CreateSlot | 支援 | BotId |
| CreateSlotType | 支援 | BotId |
| CreateUploadUrl | 否 | |
| DeleteBot | 支援 | BotId、BotAliasId |
| DeleteBotAlias | 支援 | BotAliasId |
| DeleteBotChannel 【僅限許可】 | 支援 | BotId |
| DeleteBotLocale | 支援 | BotId |
| DeleteBotVersion | 支援 | BotId |
| DeleteExport | 支援 | BotId |
| DeleteImport | 支援 | BotId |
| DeleteIntent | 支援 | BotId |
| DeleteResourcePolicy | 支援 | BotId、BotAliasId |
| DeleteSession | 支援 | BotAliasId |
| DeleteSlot | 支援 | BotId |
| DeleteSlotType | 支援 | BotId |
| DescribeBot | 支援 | BotId |
| DescribeBotAlias | 支援 | BotAliasId |
| DescribeBotChannel 【僅限許可】 | 支援 | BotId |
| DescribeBotLocale | 支援 | BotId |
| DescribeBotVersion | 支援 | BotId |
| DescribeExport | 支援 | BotId |
| DescribeImport | 支援 | BotId |
| DescribeIntent | 支援 | BotId |
| DescribeResourcePolicy | 支援 | BotId、BotAliasId |
| DescribeSlot | 支援 | BotId |
| DescribeSlotType | 支援 | BotId |
| GetSession | 支援 | BotAliasId |
| ListBotAliases | 支援 | BotId |
| ListBotChannels 【僅限許可】 | 支援 | BotId |
| ListBotLocales | 支援 | BotId |
| ListBots | 否 | |
| ListBotVersions | 支援 | BotId |
| ListBuiltInIntents | 否 | |
| ListBuiltIntSlotTypes | 否 | |
| ListExports | 否 | |
| ListImports | 否 | |
| ListIntents | 支援 | BotId |
| ListSlots | 支援 | BotId |
| ListSlotTypes | 支援 | BotId |
| PutSession | 支援 | BotAliasId |
| RecognizeText | 支援 | BotAliasId |
| RecognizeUtterance | 支援 | BotAliasId |
| StartConversation | 支援 | BotAliasId |
| StartImport | 支援 | BotId、BotAliasId |
| TagResource | 否 | |
| UpdateBot | 支援 | BotId |
| UpdateBotAlias | 支援 | BotAliasId |
| UpdateBotLocale | 支援 | BotId |
| UpdateBotVersion | 支援 | BotId |
| UpdateExport | 支援 | BotId |
| UpdateIntent | 支援 | BotId |
| UpdateResourcePolicy | 支援 | BotId、BotAliasId |
| UpdateSlot | 支援 | BotId |
| UpdateSlotType | 支援 | BotId |
| UntagResource | 否 | |
若要了解如何將資源型政策連接至機器人或機器人別名，請參閱 [Amazon Lex V2 的資源型政策範例](security_iam_resource-based-policy-examples.md)。
### Amazon Lex V2 中的資源型政策範例
若要檢視 Amazon Lex V2 資源型政策的範例，請參閱 [Amazon Lex V2 的資源型政策範例](security_iam_resource-based-policy-examples.md)。
## Amazon Lex V2 的政策動作
**支援政策動作：***是*
管理員可以使用 AWS JSON 政策來指定誰可以存取哪些內容。也就是說，哪個**主體**在什麼**條件**下可以對什麼**資源**執行哪些**動作**。
JSON 政策的 `Action` 元素描述您可以用來允許或拒絕政策中存取的動作。政策會使用動作來授予執行相關聯動作的許可。
若要查看 Amazon Lex V2 動作的清單，請參閱*《服務授權參考*》中的 [Amazon Lex V2 定義的動作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlexv2.html#amazonlexv2-actions-as-permissions)。
Amazon Lex V2 中的政策動作在動作之前使用下列字首：
```
lex
```
若要在單一陳述式中指定多個動作，請用逗號分隔。
```
"Action": [
"lex:action1",
"lex:action2"
]
```
若要檢視 Amazon Lex V2 身分型政策的範例，請參閱 [Amazon Lex V2 的身分型政策範例](security_iam_id-based-policy-examples.md)。
## Amazon Lex V2 的政策資源
**支援政策資源：***是*
管理員可以使用 AWS JSON 政策來指定誰可以存取哪些內容。也就是說，哪個**主體**在什麼**條件**下可以對什麼**資源**執行哪些**動作**。
`Resource` JSON 政策元素可指定要套用動作的物件。最佳實務是使用其 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 來指定資源。若動作不支援資源層級許可，使用萬用字元 (\$1) 表示該陳述式適用於所有資源。
```
"Resource": "*"
```
若要查看 Amazon Lex V2 資源類型及其 ARNs，請參閱*《服務授權參考*》中的 [Amazon Lex V2 定義的資源](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlexv2.html#amazonlexv2-resources-for-iam-policies)。若要了解您可以使用哪些動作指定每個資源的 ARN，請參閱 [Amazon Lex V2 定義的動作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlexv2.html#amazonlexv2-actions-as-permissions)。
若要檢視 Amazon Lex V2 身分型政策的範例，請參閱 [Amazon Lex V2 的身分型政策範例](security_iam_id-based-policy-examples.md)。
## Amazon Lex V2 的政策條件索引鍵
**支援服務特定的政策條件索引鍵：***否*
管理員可以使用 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 Lex V2 條件索引鍵的清單，請參閱*《服務授權參考*》中的 [Amazon Lex V2 的條件索引鍵](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlexv2.html#amazonlexv2-policy-keys)。若要了解您可以使用條件金鑰的動作和資源，請參閱 [Amazon Lex V2 定義的動作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlexv2.html#amazonlexv2-actions-as-permissions)。
若要檢視 Amazon Lex V2 身分型政策的範例，請參閱 [Amazon Lex V2 的身分型政策範例](security_iam_id-based-policy-examples.md)。
## Amazon Lex V2 中的存取控制清單 (ACLs)
**支援 ACLs：***否*
存取控制清單 (ACL) 可控制哪些主體 (帳戶成員、使用者或角色) 擁有存取某資源的許可。ACL 類似於資源型政策，但它們不使用 JSON 政策文件格式。
## 使用 Amazon Lex V2 的屬性型存取控制 (ABAC)
**支援 ABAC （政策中的標籤）：***是*
屬性型存取控制 (ABAC) 是一種授權策略，依據稱為標籤的屬性來定義許可。您可以將標籤連接至 IAM 實體和 AWS 資源，然後設計 ABAC 政策，以便在委託人的標籤符合資源上的標籤時允許操作。
如需根據標籤控制存取，請使用 `aws:ResourceTag/key-name`、`aws:RequestTag/key-name` 或 `aws:TagKeys` 條件索引鍵，在政策的[條件元素](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)中，提供標籤資訊。
如果服務支援每個資源類型的全部三個條件金鑰，則對該服務而言，值為 **Yes**。如果服務僅支援某些資源類型的全部三個條件金鑰，則值為 **Partial**。
如需 ABAC 的詳細資訊，請參閱《*IAM 使用者指南*》中的[使用 ABAC 授權定義許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html)。如要查看含有設定 ABAC 步驟的教學課程，請參閱《*IAM 使用者指南*》中的[使用屬性型存取控制 (ABAC)](https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html)。
## 搭配 Amazon Lex V2 使用暫時登入資料
**支援臨時登入資料：***否*
暫時登入資料可讓您短期存取 AWS 資源，並在您使用聯合或切換角色時自動建立。AWS 建議您動態產生臨時憑證，而不是使用長期存取金鑰。如需詳細資訊，請參閱《*IAM 使用者指南*》中的 [IAM 中的臨時安全憑證](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html)與[可與 IAM 搭配運作的AWS 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。
## Amazon Lex V2 的跨服務主體許可
**支援轉送存取工作階段 (FAS)：***是*
轉送存取工作階段 (FAS) 使用呼叫 的委託人許可 AWS 服務，並結合 請求 AWS 服務 向下游服務提出請求。如需提出 FAS 請求時的政策詳細資訊，請參閱[轉發存取工作階段](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html)。
## Amazon Lex V2 的服務角色
**支援服務角色：***是*
服務角色是服務擔任的 [IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)，可代您執行動作。IAM 管理員可以從 IAM 內建立、修改和刪除服務角色。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[建立角色以委派許可給 AWS 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html)。
**警告**
變更服務角色的許可可能會中斷 Amazon Lex V2 功能。只有在 Amazon Lex V2 提供指引時，才能編輯服務角色。
## Amazon Lex V2 的服務連結角色
**支援服務連結角色：***部分*
服務連結角色是連結至 的一種服務角色 AWS 服務。服務可以擔任代表您執行動作的角色。服務連結角色會出現在您的 中 AWS 帳戶 ，並由服務擁有。IAM 管理員可以檢視，但不能編輯服務連結角色的許可。
如需建立或管理服務連結角色的詳細資訊，請參閱[使用 IAM 的 AWS 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。在資料表中尋找服務，其中包含**服務連結角色**欄中的 `Yes`。選擇**是**連結，以檢視該服務的服務連結角色文件。
# Amazon Lex V2 的身分型政策範例
根據預設，使用者和角色沒有建立或修改 Amazon Lex V2 資源的許可。若要授予使用者對其所需資源執行動作的許可，IAM 管理員可以建立 IAM 政策。
如需了解如何使用這些範例 JSON 政策文件建立 IAM 身分型政策，請參閱《*IAM 使用者指南*》中的[建立 IAM 政策 (主控台)](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html)。
如需 Amazon Lex V2 定義的動作和資源類型的詳細資訊，包括每種資源類型的 ARNs 格式，請參閱*《服務授權參考*》中的 [Amazon Lex V2 的動作、資源和條件索引鍵](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlexv2.html)。
**Topics**
+ [政策最佳實務](#security_iam_service-with-iam-policy-best-practices)
+ [使用 Amazon Lex V2 主控台](#security_iam_id-based-policy-examples-console)
+ [允許使用者將函數新增至機器人](#security_iam-bot-role)
+ [允許使用者將頻道新增至機器人](#security_iam-channel-role)
+ [允許使用者建立和更新機器人](#security_iam-bot-create-update)
+ [允許使用者使用自動化 Chatbot 設計工具](#security_iam-bot-designer)
+ [允許使用者使用 AWS KMS 金鑰來加密和解密檔案](#security_iam-bot-key)
+ [允許使用者刪除機器人](#security_iam-bot-delete)
+ [允許使用者與機器人進行對話](#security_iam-bot-conversation)
+ [允許特定使用者管理以資源為基礎的政策](#security_iam_id-based-policy-examples-allow-resource)
+ [允許使用者匯出機器人和機器人地區設定](#security_iam_id-based-policy-examples-export)
+ [允許使用者匯出自訂詞彙](#security_iam_id-based-policy-examples-import-vocab)
+ [允許使用者匯入機器人和機器人地區設定](#security_iam_id-based-policy-examples-import)
+ [允許使用者匯入自訂詞彙](#secruity_iam_id-based-policy-examples-import-vocab)
+ [允許使用者將機器人從 Amazon Lex 遷移至 Amazon Lex V2](#security_iam_id-based-policy-examples-migrate)
+ [允許使用者檢視他們自己的許可](#security_iam_id-based-policy-examples-view-own-permissions)
+ [允許使用者在 Amazon Lex V2 中使用視覺化對話建置器繪製對話流程](#security_iam_allow-draw-conversation-flow)
+ [允許使用者建立和檢視機器人複本，但不能刪除它們](#security_iam_id-based-policy-examples-gr-permissions)
## 政策最佳實務
身分型政策會判斷您帳戶中的某個人員是否可以建立、存取或刪除 Amazon Lex V2 資源。這些動作可能會讓您的 AWS 帳戶產生費用。當您建立或編輯身分型政策時，請遵循下列準則及建議事項：
+ **開始使用 AWS 受管政策並邁向最低權限許可** – 若要開始將許可授予使用者和工作負載，請使用將許可授予許多常見使用案例的 *AWS 受管政策*。它們可在您的 中使用 AWS 帳戶。我們建議您定義特定於使用案例的 AWS 客戶受管政策，以進一步減少許可。如需詳細資訊，請參閱《*IAM 使用者指南*》中的 [ AWS 受管政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies)或[任務函數的 AWS 受管政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_job-functions.html)。
+ **套用最低權限許可** – 設定 IAM 政策的許可時，請僅授予執行任務所需的許可。為實現此目的，您可以定義在特定條件下可以對特定資源採取的動作，這也稱為*最低權限許可*。如需使用 IAM 套用許可的更多相關資訊，請參閱《*IAM 使用者指南*》中的 [IAM 中的政策和許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)。
+ **使用 IAM 政策中的條件進一步限制存取權** – 您可以將條件新增至政策，以限制動作和資源的存取。例如，您可以撰寫政策條件，指定必須使用 SSL 傳送所有請求。如果透過特定 例如 使用服務動作 AWS 服務，您也可以使用條件來授予其存取權 CloudFormation。如需詳細資訊，請參閱《*IAM 使用者指南*》中的 [IAM JSON 政策元素：條件](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)。
+ **使用 IAM Access Analyzer 驗證 IAM 政策，確保許可安全且可正常運作** – IAM Access Analyzer 驗證新政策和現有政策，確保這些政策遵從 IAM 政策語言 (JSON) 和 IAM 最佳實務。IAM Access Analyzer 提供 100 多項政策檢查及切實可行的建議，可協助您撰寫安全且實用的政策。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[使用 IAM Access Analyzer 驗證政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-validation.html)。
+ **需要多重要素驗證 (MFA)** – 如果您的案例需要 IAM 使用者或 中的根使用者 AWS 帳戶，請開啟 MFA 以提高安全性。如需在呼叫 API 操作時請求 MFA，請將 MFA 條件新增至您的政策。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[透過 MFA 的安全 API 存取](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_configure-api-require.html)。
如需 IAM 中最佳實務的相關資訊，請參閱《*IAM 使用者指南*》中的 [IAM 安全最佳實務](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)。
## 使用 Amazon Lex V2 主控台
若要存取 Amazon Lex V2 主控台，您必須擁有一組最低許可。這些許可必須允許您列出和檢視 中 Amazon Lex V2 資源的詳細資訊 AWS 帳戶。如果您建立比最基本必要許可更嚴格的身分型政策，則對於具有該政策的實體 (使用者或角色) 而言，主控台就無法如預期運作。
您不需要針對只呼叫 AWS CLI 或 AWS API 的使用者允許最基本的主控台許可。反之，只需允許存取符合他們嘗試執行之 API 操作的動作就可以了。
為了確保使用者和角色仍然可以使用 Amazon Lex V2 主控台，使用者需要具有主控台存取權。如需使用主控台存取建立使用者的詳細資訊，請參閱《[IAM 使用者指南》中的在您的 AWS 帳戶中建立](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html) *IAM* 使用者。
## 允許使用者將函數新增至機器人
此範例顯示的政策允許 IAM 使用者將 Amazon Comprehend、情緒分析和 Amazon Kendra 查詢許可新增至 Amazon Lex V2 機器人。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Id1",
"Effect": "Allow",
"Action": "iam:PutRolePolicy",
"Resource": "arn:aws:iam::*:role/aws-service-role/lexv2.amazonaws.com/AWSServiceRoleForLexV2Bots*"
},
{
"Sid": "Id2",
"Effect": "Allow",
"Action": "iam:GetRolePolicy",
"Resource": "arn:aws:iam::*:role/aws-service-role/lexv2.amazonaws.com/AWSServiceRoleForLexV2Bots*"
}
]
}
```
------
## 允許使用者將頻道新增至機器人
此範例是允許 IAM 使用者將訊息管道新增至機器人的政策。使用者必須先備妥此政策，才能在訊息平台上部署機器人。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Id1",
"Effect": "Allow",
"Action": "iam:PutRolePolicy",
"Resource": "arn:aws:iam::*:role/aws-service-role/channels.lexv2.amazonaws.com/AWSServiceRoleForLexV2Channels*"
},
{
"Sid": "Id2",
"Effect": "Allow",
"Action": "iam:GetRolePolicy",
"Resource": "arn:aws:iam::*:role/aws-service-role/channels.lexv2.amazonaws.com/AWSServiceRoleForLexV2Channels*"
}
]
}
```
------
## 允許使用者建立和更新機器人
此範例顯示允許 IAM 使用者建立和更新任何機器人的範例政策。此政策包含在主控台或使用 AWS CLI 或 AWS API 完成此動作的許可。
## 允許使用者使用自動化 Chatbot 設計工具
此範例顯示允許 IAM 使用者執行自動化 Chatbot 設計工具的範例政策。
## 允許使用者使用 AWS KMS 金鑰來加密和解密檔案
此範例顯示允許 IAM 使用者使用 AWS KMS 客戶受管金鑰來加密和解密資料的範例政策。
## 允許使用者刪除機器人
此範例顯示允許 IAM 使用者刪除任何機器人的範例政策。此政策包含在主控台或使用 AWS CLI 或 AWS API 完成此動作的許可。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"lex:DeleteBot",
"lex:DeleteBotLocale",
"lex:DeleteBotAlias",
"lex:DeleteIntent",
"lex:DeleteSlot",
"lex:DeleteSlottype"
],
"Effect": "Allow",
"Resource": [
"arn:aws:lex:us-east-1:123412341234:bot/*",
"arn:aws:lex:us-east-1:123412341234:bot-alias/*"
]
}
]
}
```
------
## 允許使用者與機器人進行對話
此範例顯示允許 IAM 使用者與任何機器人對話的範例政策。此政策包含在主控台或使用 AWS CLI 或 AWS API 完成此動作的許可。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"lex:StartConversation",
"lex:RecognizeText",
"lex:RecognizeUtterance",
"lex:GetSession",
"lex:PutSession",
"lex:DeleteSession"
],
"Effect": "Allow",
"Resource": "arn:aws:lex:us-east-1:123412341234:bot-alias/*"
}
]
}
```
------
## 允許特定使用者管理以資源為基礎的政策
下列範例會授予特定使用者管理資源型政策的許可。它允許主控台和 API 存取與機器人和機器人別名相關聯的政策。
## 允許使用者匯出機器人和機器人地區設定
下列 IAM 許可政策可讓使用者建立、更新和取得機器人或機器人地區設定的匯出。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"lex:CreateExport",
"lex:UpdateExport",
"lex:DescribeExport",
"lex:DescribeBot",
"lex:DescribeBotLocale",
"lex:ListBotLocales",
"lex:DescribeIntent",
"lex:ListIntents",
"lex:DescribeSlotType",
"lex:ListSlotTypes",
"lex:DescribeSlot",
"lex:ListSlots",
"lex:DescribeCustomVocabulary"
],
"Effect": "Allow",
"Resource": [
"arn:aws:lex:us-east-1:123456789012:bot/*"
]
}
]
}
```
------
## 允許使用者匯出自訂詞彙
下列 IAM 許可政策允許使用者從機器人地區設定匯出自訂詞彙。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"lex:CreateExport",
"lex:UpdateExport",
"lex:DescribeExport",
"lex:DescribeCustomVocabulary"
],
"Effect": "Allow",
"Resource": [
"arn:aws:lex:us-east-1:123456789012:bot/*"
]
}
]
}
```
------
## 允許使用者匯入機器人和機器人地區設定
下列 IAM 許可政策可讓使用者匯入機器人或機器人地區設定，並檢查匯入的狀態。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"lex:CreateUploadUrl",
"lex:StartImport",
"lex:DescribeImport",
"lex:CreateBot",
"lex:UpdateBot",
"lex:DeleteBot",
"lex:CreateBotLocale",
"lex:UpdateBotLocale",
"lex:DeleteBotLocale",
"lex:CreateIntent",
"lex:UpdateIntent",
"lex:DeleteIntent",
"lex:CreateSlotType",
"lex:UpdateSlotType",
"lex:DeleteSlotType",
"lex:CreateSlot",
"lex:UpdateSlot",
"lex:DeleteSlot",
"lex:CreateCustomVocabulary",
"lex:UpdateCustomVocabulary",
"lex:DeleteCustomVocabulary",
"iam:PassRole"
],
"Effect": "Allow",
"Resource": [
"arn:aws:lex:us-east-1:123456789012:bot/*",
"arn:aws:lex:us-east-1:123456789012:bot-alias/*"
]
}
]
}
```
------
## 允許使用者匯入自訂詞彙
下列 IAM 許可政策允許使用者將自訂詞彙匯入機器人地區設定。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"lex:CreateUploadUrl",
"lex:StartImport",
"lex:DescribeImport",
"lex:CreateCustomVocabulary",
"lex:UpdateCustomVocabulary",
"lex:DeleteCustomVocabulary"
],
"Effect": "Allow",
"Resource": [
"arn:aws:lex:us-east-1:123456789012:bot/*"
]
}
]
}
```
------
## 允許使用者將機器人從 Amazon Lex 遷移至 Amazon Lex V2
下列 IAM 許可政策允許使用者開始將機器人從 Amazon Lex 遷移至 Amazon Lex V2。
## 允許使用者檢視他們自己的許可
此範例會示範如何建立政策，允許 IAM 使用者檢視附加到他們使用者身分的內嵌及受管政策。此政策包含在主控台上，或是使用 AWS CLI 或 AWS API 透過編寫程式的方式完成此動作的許可。
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "ViewOwnUserInfo",
"Effect": "Allow",
"Action": [
"iam:GetUserPolicy",
"iam:ListGroupsForUser",
"iam:ListAttachedUserPolicies",
"iam:ListUserPolicies",
"iam:GetUser"
],
"Resource": ["arn:aws:iam::*:user/${aws:username}"]
},
{
"Sid": "NavigateInConsole",
"Effect": "Allow",
"Action": [
"iam:GetGroupPolicy",
"iam:GetPolicyVersion",
"iam:GetPolicy",
"iam:ListAttachedGroupPolicies",
"iam:ListGroupPolicies",
"iam:ListPolicyVersions",
"iam:ListPolicies",
"iam:ListUsers"
],
"Resource": "*"
}
]
}
```
## 允許使用者在 Amazon Lex V2 中使用視覺化對話建置器繪製對話流程
下列 IAM 許可政策允許使用者在 Amazon Lex V2 中使用視覺化對話建置器繪製對話流程。
## 允許使用者建立和檢視機器人複本，但不能刪除它們
您可以將下列許可連接至 IAM 角色，以允許其僅建立和檢視機器人複本。透過省略 `lex:DeleteBotReplica`，您可以防止角色刪除機器人複本。如需詳細資訊，請參閱[在 Lex V2 中複寫機器人和管理機器人複本的許可](gr-permissions.md)。
# Amazon Lex V2 的資源型政策範例
以*資源為基礎的政策*會連接到資源，例如機器人或機器人別名。透過以資源為基礎的政策，您可以指定誰可以存取資源，以及他們可以對其執行的動作。例如，您可以新增資源型政策，讓使用者修改特定機器人，或允許使用者在特定機器人別名上使用執行期操作。
當您使用以資源為基礎的政策時，您可以允許其他 AWS 服務存取您帳戶中的資源。例如，您可以允許 Amazon Connect 存取 Amazon Lex V2 機器人。
若要了解如何建立機器人或機器人別名，請參閱 [使用 Amazon Lex V2 機器人](building-bots.md)。
**Topics**
+ [使用 主控台指定以資源為基礎的政策](#security_iam_resource-based-policy-examples-console)
+ [使用 API 指定以資源為基礎的政策](#security_iam_resource-based-policy-examples-api)
+ [允許 IAM 角色更新機器人並列出機器人別名](#security_iam_resource-based-policy-examples-allow-lex-models)
+ [允許使用者與機器人進行對話](#security_iam_resource-based-policy-examples-allow-lex-runtime)
+ [允許 AWS 服務使用特定的 Amazon Lex V2 機器人](#security_iam_resource-based-policy-examples-allow-lex-connect)
## 使用 主控台指定以資源為基礎的政策
您可以使用 Amazon Lex V2 主控台來管理機器人和機器人別名的資源型政策。您可以輸入政策的 JSON 結構，並且主控台會將其與資源建立關聯。如果已有與資源相關聯的政策，您可以使用 主控台來檢視和修改政策。
當您使用政策編輯器儲存政策時，主控台會檢查政策的語法。如果政策包含錯誤，例如不存在的使用者或資源不支援的動作，則會傳回錯誤，且不會儲存政策。
以下顯示 主控台中機器人的資源型政策編輯器。機器人別名的政策編輯器類似。
![\[\]](http://docs.aws.amazon.com/zh_tw/lexv2/latest/dg/images/resource-policy-editor.png)
**開啟機器人的政策編輯器**
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/) 開啟 Amazon Lex 主控台。
1. 從**機器人**清單中，選擇您要編輯其政策的機器人。
1. 在**資源型政策**區段中，選擇**編輯**。
**開啟機器人別名的政策編輯器**
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/) 開啟 Amazon Lex 主控台。
1. 從**機器人**清單中，選擇包含您要編輯之別名的機器人。
1. 從左側功能表中，選擇**別名**，然後選擇要編輯的別名。
1. 在**資源型政策**區段中，選擇**編輯**。
## 使用 API 指定以資源為基礎的政策
您可以使用 API 操作來管理機器人和機器人別名的資源型政策。有操作可以建立、更新和刪除政策。
[CreateResourcePolicy](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateResourcePolicy.html)
將具有指定政策陳述式的新資源政策新增至機器人或機器人別名。
[CreateResourcePolicyStatement](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateResourcePolicyStatement.html)
將新的資源政策陳述式新增至機器人或機器人別名。
[DeleteResourcePolicy](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DeleteResourcePolicy.html)
從機器人或機器人別名移除資源政策。
[DeleteResourcePolicyStatement](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DeleteResourcePolicyStatement.html)
從機器人或機器人別名移除資源政策陳述式。
[DescribeResourcePolicy](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DescribeResourcePolicy.html)
取得資源政策和政策修訂。
[UpdateResourcePolicy](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateResourcePolicy.html)
將機器人或機器人別名的現有資源政策取代為新的資源政策。
### 範例
------
#### [ Java ]
下列範例示範如何使用以資源為基礎的政策操作來管理以資源為基礎的政策。
```
/*
* Create a new policy for the specified bot alias
* that allows a role to invoke lex:UpdateBotAlias on it.
* The created policy will have revision id 1.
*/
CreateResourcePolicyRequest createPolicyRequest =
CreateResourcePolicyRequest.builder()
.resourceArn("arn:aws:lex:Region:123456789012:bot-alias/MYBOTALIAS/TSTALIASID")
.policy("{\"Version\": \"2012-10-17\",\"Statement\": [{\"Sid\": \"BotAliasEditor\",\"Effect\": \"Allow\",\"Principal\": {\"AWS\": \"arn:aws:iam::123456789012:role/BotAliasEditor\"},\"Action\": [\"lex:UpdateBotAlias\"],\"Resource\":[\"arn:aws:lex:Region:123456789012:bot-alias/MYBOTALIAS/TSTALIASID\"]]}")
lexmodelsv2Client.createResourcePolicy(createPolicyRequest);
/*
* Overwrite the policy for the specified bot alias with a new policy.
* Since no expectedRevisionId is provided, this request overwrites the current revision.
* After this update, the revision id for the policy is 2.
*/
UpdateResourcePolicyRequest updatePolicyRequest =
UpdateResourcePolicyRequest.builder()
.resourceArn("arn:aws:lex:Region:123456789012:bot-alias/MYBOTALIAS/TSTALIASID")
.policy("{\"Version\": \"2012-10-17\",\"Statement\": [{\"Sid\": \"BotAliasEditor\",\"Effect\": \"Deny\",\"Principal\": {\"AWS\": \"arn:aws:iam::123456789012:role/BotAliasEditor\"},\"Action\": [\"lex:UpdateBotAlias\"],\"Resource\":[\"arn:aws:lex:Region:123456789012:bot-alias/MYBOTALIAS/TSTALIASID\"]]}")
lexmodelsv2Client.updateResourcePolicy(updatePolicyRequest);
/*
* Creates a statement in an existing policy for the specified bot alias
* that allows a role to invoke lex:RecognizeText on it.
* This request expects to update revision 2 of the policy. The request will fail
* if the current revision of the policy is no longer revision 2.
* After this request, the revision id for this policy will be 3.
*/
CreateResourcePolicyStatementRequest createStatementRequest =
CreateResourcePolicyStatementRequest.builder()
.resourceArn("arn:aws:lex:Region:123456789012:bot-alias/MYBOTALIAS/TSTALIASID")
.effect("Allow")
.principal(Principal.builder().arn("arn:aws:iam::123456789012:role/BotRunner").build())
.action("lex:RecognizeText")
.statementId("BotRunnerStatement")
.expectedRevisionId(2)
.build();
lexmodelsv2Client.createResourcePolicyStatement(createStatementRequest);
/*
* Deletes a statement from an existing policy for the specified bot alias by statementId.
* Since no expectedRevisionId is supplied, the request will remove the statement from
* the current revision of the policy for the bot alias.
* After this request, the revision id for this policy will be 4.
*/
DeleteResourcePolicyRequest deleteStatementRequest =
DeleteResourcePolicyRequest.builder()
.resourceArn("arn:aws:lex:Region:123456789012:bot-alias/MYBOTALIAS/TSTALIASID")
.statementId("BotRunnerStatement")
.build();
lexmodelsv2Client.deleteResourcePolicy(deleteStatementRequest);
/*
* Describe the current policy for the specified bot alias
* It always returns the current revision.
*/
DescribeResourcePolicyRequest describePolicyRequest =
DescribeResourcePolicyRequest.builder()
.resourceArn("arn:aws:lex:Region:123456789012:bot-alias/MYBOTALIAS/TSTALIASID")
.build();
lexmodelsv2Client.describeResourcePolicy(describePolicyRequest);
/*
* Delete the current policy for the specified bot alias
* This request expects to delete revision 3 of the policy. Since the revision id for
* this policy is already at 4, this request will fail.
*/
DeleteResourcePolicyRequest deletePolicyRequest =
DeleteResourcePolicyRequest.builder()
.resourceArn("arn:aws:lex:Region:123456789012:bot-alias/MYBOTALIAS/TSTALIASID")
.expectedRevisionId(3);
.build();
lexmodelsv2Client.deleteResourcePolicy(deletePolicyRequest);
```
------
## 允許 IAM 角色更新機器人並列出機器人別名
下列範例會授予特定 IAM 角色許可，以呼叫 Amazon Lex V2 模型建置 API 操作來修改現有機器人。使用者可以列出機器人的別名並更新機器人，但無法刪除機器人或機器人別名。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "botBuilders",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::123456789012:role/BotBuilder"
},
"Action": [
"lex:ListBotAliases",
"lex:UpdateBot"
],
"Resource": [
"arn:aws:lex:us-east-1:123456789012:bot/MYBOT"
]
}
]
}
```
------
## 允許使用者與機器人進行對話
下列範例授予特定使用者在機器人的單一別名上呼叫 Amazon Lex V2 執行時間 API 操作的許可。
使用者明確拒絕更新或刪除機器人別名的許可。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "botRunners",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::123456789012:user/botRunner"
},
"Action": [
"lex:RecognizeText",
"lex:RecognizeUtterance",
"lex:StartConversation",
"lex:DeleteSession",
"lex:GetSession",
"lex:PutSession"
],
"Resource": [
"arn:aws:lex:us-east-1:123456789012:bot-alias/MYBOT/MYBOTALIAS"
]
},
{
"Sid": "botRunners",
"Effect": "Deny",
"Principal": {
"AWS": "arn:aws:iam::123456789012:user/botRunner"
},
"Action": [
"lex:UpdateBotAlias",
"lex:DeleteBotAlias"
],
"Resource": [
"arn:aws:lex:us-east-1:123456789012:bot-alias/MYBOT/MYBOTALIAS"
]
}
]
}
```
------
## 允許 AWS 服務使用特定的 Amazon Lex V2 機器人
下列範例授予 AWS Lambda 和 Amazon Connect 呼叫 Amazon Lex V2 執行時間 API 操作的許可。
服務主體需要 條件區塊，且必須使用全域內容金鑰 `AWS:SourceAccount`和 `AWS:SourceArn`。
`AWS:SourceAccount` 是呼叫 Amazon Lex V2 機器人的帳戶 ID。
`AWS:SourceArn` 是對 Amazon Lex V2 機器人別名發出的 Amazon Connect 服務執行個體或 Lambda 函數的資源 ARN。 Amazon Lex V2
# Amazon Lex V2 的 AWS 受管政策
AWS 托管策略 是由 AWS 创建和管理的独立策略。AWS 受管政策旨在為許多常用案例提供許可，以便您可以開始將許可指派給使用者、群組和角色。
請記住，AWS 受管政策可能不會授予特定使用案例的最低權限許可，因為這些許可可供所有 AWS 客戶使用。我們建議您定義特定於使用案例的[客戶管理政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#customer-managed-policies)，以便進一步減少許可。
您無法變更 AWS 受管政策中定義的許可。如果 AWS 更新 AWS 受管政策中定義的許可，則更新會影響政策連接的所有主體身分 （使用者、群組和角色）。當新的 AWS 服務 啟動或新的 API 操作可用於現有服務時，AWS 最有可能更新 AWS 受管政策。
如需詳細資訊，請參閱《*IAM 使用者指南*》中的 [AWS 受管政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies)。
## AWS 受管政策：AmazonLexReadOnly
您可將 `AmazonLexReadOnly` 政策連接到 IAM 身分。
此政策授予唯讀許可，允許使用者檢視 Amazon Lex V2 和 Amazon Lex 模型建置服務中的所有動作。
**許可詳細資訊**
此政策包含以下許可：
+ `lex` – 在模型建置服務中唯讀存取 Amazon Lex V2 和 Amazon Lex 資源。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AmazonLexReadOnlyStatement1",
"Effect": "Allow",
"Action": [
"lex:GetBot",
"lex:GetBotAlias",
"lex:GetBotAliases",
"lex:GetBots",
"lex:GetBotChannelAssociation",
"lex:GetBotChannelAssociations",
"lex:GetBotVersions",
"lex:GetBuiltinIntent",
"lex:GetBuiltinIntents",
"lex:GetBuiltinSlotTypes",
"lex:GetIntent",
"lex:GetIntents",
"lex:GetIntentVersions",
"lex:GetSlotType",
"lex:GetSlotTypes",
"lex:GetSlotTypeVersions",
"lex:GetUtterancesView",
"lex:DescribeBot",
"lex:DescribeBotAlias",
"lex:DescribeBotChannel",
"lex:DescribeBotLocale",
"lex:DescribeBotRecommendation",
"lex:DescribeBotReplica",
"lex:DescribeBotVersion",
"lex:DescribeExport",
"lex:DescribeImport",
"lex:DescribeIntent",
"lex:DescribeResourcePolicy",
"lex:DescribeSlot",
"lex:DescribeSlotType",
"lex:ListBots",
"lex:ListBotLocales",
"lex:ListBotAliases",
"lex:ListBotAliasReplicas",
"lex:ListBotChannels",
"lex:ListBotRecommendations",
"lex:ListBotReplicas",
"lex:ListBotVersions",
"lex:ListBotVersionReplicas",
"lex:ListBuiltInIntents",
"lex:ListBuiltInSlotTypes",
"lex:ListExports",
"lex:ListImports",
"lex:ListIntents",
"lex:ListRecommendedIntents",
"lex:ListSlots",
"lex:ListSlotTypes",
"lex:ListTagsForResource",
"lex:SearchAssociatedTranscripts",
"lex:ListCustomVocabularyItems"
],
"Resource": "*"
}
]
}
```
------
## AWS 受管政策：AmazonLexRunBotsOnly
您可將 `AmazonLexRunBotsOnly` 政策連接到 IAM 身分。
此政策授予唯讀許可，允許執行 Amazon Lex V2 和 Amazon Lex 對話式機器人的存取權。
**許可詳細資訊**
此政策包含以下許可：
+ `lex` – Amazon Lex V2 和 Amazon Lex 執行時間中所有動作的唯讀存取權。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"lex:PostContent",
"lex:PostText",
"lex:PutSession",
"lex:GetSession",
"lex:DeleteSession",
"lex:RecognizeText",
"lex:RecognizeUtterance",
"lex:StartConversation"
],
"Resource": "*"
}
]
}
```
------
## AWS 受管政策：AmazonLexFullAccess
您可將 `AmazonLexFullAccess` 政策連接到 IAM 身分。
此政策授予管理許可，允許使用者建立、讀取、更新和刪除 Amazon Lex V2 和 Amazon Lex 資源，以及執行 Amazon Lex V2 和 Amazon Lex 對話式機器人。
**許可詳細資訊**
此政策包含以下許可：
+ `lex` – 允許主體讀取和寫入存取 Amazon Lex V2 和 Amazon Lex 模型建置和執行時間服務中的所有動作。
+ `cloudwatch` – 允許主體檢視 Amazon CloudWatch 指標和警示。
+ `iam` – 允許主體建立和刪除服務連結角色、傳遞角色，以及將政策連接到角色並分離。Amazon Lex 操作的許可僅限於「lex.amazonaws.com」，Amazon Lex V2 操作的許可僅限於「lexv2.amazonaws.com」。
+ `kendra` – 允許主體列出 Amazon Kendra 索引。
+ `kms` – 允許主體描述 AWS KMS 金鑰和別名。
+ `lambda` – 允許主體列出 AWS Lambda 函數和管理連接到任何 Lambda 函數的許可。
+ `polly` – 允許主體描述 Amazon Polly 語音和合成語音。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AmazonLexFullAccessStatement1",
"Effect": "Allow",
"Action": [
"cloudwatch:GetMetricStatistics",
"cloudwatch:DescribeAlarms",
"cloudwatch:DescribeAlarmsForMetric",
"kms:DescribeKey",
"kms:ListAliases",
"lambda:GetPolicy",
"lambda:ListFunctions",
"lambda:ListAliases",
"lambda:ListVersionsByFunction",
"lex:*",
"polly:DescribeVoices",
"polly:SynthesizeSpeech",
"kendra:ListIndices",
"iam:ListRoles",
"s3:ListAllMyBuckets",
"logs:DescribeLogGroups",
"s3:GetBucketLocation"
],
"Resource": [
"*"
]
},
{
"Sid": "AmazonLexFullAccessStatement2",
"Effect": "Allow",
"Action": [
"bedrock:ListFoundationModels"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"bedrock:InvokeModel"
],
"Resource": "arn:aws:bedrock:*::foundation-model/*"
},
{
"Effect": "Allow",
"Action": [
"lambda:AddPermission",
"lambda:RemovePermission"
],
"Resource": "arn:aws:lambda:*:*:function:AmazonLex*",
"Condition": {
"StringEquals": {
"lambda:Principal": "lex.amazonaws.com"
}
}
},
{
"Sid": "AmazonLexFullAccessStatement3",
"Effect": "Allow",
"Action": [
"iam:GetRole",
"iam:GetRolePolicy"
],
"Resource": [
"arn:aws:iam::*:role/aws-service-role/lex.amazonaws.com/AWSServiceRoleForLexBots",
"arn:aws:iam::*:role/aws-service-role/channels.lex.amazonaws.com/AWSServiceRoleForLexChannels",
"arn:aws:iam::*:role/aws-service-role/lexv2.amazonaws.com/AWSServiceRoleForLexV2Bots*",
"arn:aws:iam::*:role/aws-service-role/channels.lexv2.amazonaws.com/AWSServiceRoleForLexV2Channels*",
"arn:aws:iam::*:role/aws-service-role/replication.lexv2.amazonaws.com/AWSServiceRoleForLexV2Replication*"
]
},
{
"Sid": "AmazonLexFullAccessStatement4",
"Effect": "Allow",
"Action": [
"iam:CreateServiceLinkedRole"
],
"Resource": [
"arn:aws:iam::*:role/aws-service-role/lex.amazonaws.com/AWSServiceRoleForLexBots"
],
"Condition": {
"StringEquals": {
"iam:AWSServiceName": "lex.amazonaws.com"
}
}
},
{
"Sid": "AmazonLexFullAccessStatement5",
"Effect": "Allow",
"Action": [
"iam:CreateServiceLinkedRole"
],
"Resource": [
"arn:aws:iam::*:role/aws-service-role/channels.lex.amazonaws.com/AWSServiceRoleForLexChannels"
],
"Condition": {
"StringEquals": {
"iam:AWSServiceName": "channels.lex.amazonaws.com"
}
}
},
{
"Sid": "AmazonLexFullAccessStatement6",
"Effect": "Allow",
"Action": [
"iam:CreateServiceLinkedRole"
],
"Resource": [
"arn:aws:iam::*:role/aws-service-role/lexv2.amazonaws.com/AWSServiceRoleForLexV2Bots*"
],
"Condition": {
"StringEquals": {
"iam:AWSServiceName": "lexv2.amazonaws.com"
}
}
},
{
"Sid": "AmazonLexFullAccessStatement7",
"Effect": "Allow",
"Action": [
"iam:CreateServiceLinkedRole"
],
"Resource": [
"arn:aws:iam::*:role/aws-service-role/channels.lexv2.amazonaws.com/AWSServiceRoleForLexV2Channels*"
],
"Condition": {
"StringEquals": {
"iam:AWSServiceName": "channels.lexv2.amazonaws.com"
}
}
},
{
"Sid": "AmazonLexFullAccessStatement8",
"Effect": "Allow",
"Action": [
"iam:CreateServiceLinkedRole"
],
"Resource": [
"arn:aws:iam::*:role/aws-service-role/replication.lexv2.amazonaws.com/AWSServiceRoleForLexV2Replication*"
],
"Condition": {
"StringEquals": {
"iam:AWSServiceName": "replication.lexv2.amazonaws.com"
}
}
},
{
"Sid": "AmazonLexFullAccessStatement9",
"Effect": "Allow",
"Action": [
"iam:DeleteServiceLinkedRole",
"iam:GetServiceLinkedRoleDeletionStatus"
],
"Resource": [
"arn:aws:iam::*:role/aws-service-role/lex.amazonaws.com/AWSServiceRoleForLexBots",
"arn:aws:iam::*:role/aws-service-role/channels.lex.amazonaws.com/AWSServiceRoleForLexChannels",
"arn:aws:iam::*:role/aws-service-role/lexv2.amazonaws.com/AWSServiceRoleForLexV2Bots*",
"arn:aws:iam::*:role/aws-service-role/channels.lexv2.amazonaws.com/AWSServiceRoleForLexV2Channels*",
"arn:aws:iam::*:role/aws-service-role/replication.lexv2.amazonaws.com/AWSServiceRoleForLexV2Replication*"
]
},
{
"Sid": "AmazonLexFullAccessStatement10",
"Effect": "Allow",
"Action": [
"iam:PassRole"
],
"Resource": [
"arn:aws:iam::*:role/aws-service-role/lex.amazonaws.com/AWSServiceRoleForLexBots"
],
"Condition": {
"StringEquals": {
"iam:PassedToService": [
"lex.amazonaws.com"
]
}
}
},
{
"Sid": "AmazonLexFullAccessStatement11",
"Effect": "Allow",
"Action": [
"iam:PassRole"
],
"Resource": [
"arn:aws:iam::*:role/aws-service-role/lexv2.amazonaws.com/AWSServiceRoleForLexV2Bots*"
],
"Condition": {
"StringEquals": {
"iam:PassedToService": [
"lexv2.amazonaws.com"
]
}
}
},
{
"Sid": "AmazonLexFullAccessStatement12",
"Effect": "Allow",
"Action": [
"iam:PassRole"
],
"Resource": [
"arn:aws:iam::*:role/aws-service-role/channels.lexv2.amazonaws.com/AWSServiceRoleForLexV2Channels*"
],
"Condition": {
"StringEquals": {
"iam:PassedToService": [
"channels.lexv2.amazonaws.com"
]
}
}
},
{
"Sid": "AmazonLexFullAccessStatement13",
"Effect": "Allow",
"Action": [
"iam:PassRole"
],
"Resource": [
"arn:aws:iam::*:role/aws-service-role/replication.lexv2.amazonaws.com/AWSServiceRoleForLexV2Replication*"
],
"Condition": {
"StringEquals": {
"iam:PassedToService": [
"lexv2.amazonaws.com"
]
}
}
}
]
}
```
------
## AWS 受管政策：AmazonLexReplicationPolicy
您不得將 `AmazonLexReplicationPolicy` 連接到 IAM 實體。此政策會連接到服務連結角色，允許 Amazon Lex V2 代表您執行動作。如需詳細資訊，請參閱[使用 Amazon Lex V2 的服務連結角色](using-service-linked-roles.md)。
此政策會授予管理許可，允許 Amazon Lex V2 代表您跨區域複寫 AWS 資源。您可以連接此政策，以允許角色輕鬆複寫資源，包括機器人、地區設定、版本、別名、意圖、槽類型、槽和自訂詞彙。
**許可詳細資訊**
此政策包含以下許可。
+ `lex` – 允許主體複寫其他區域中的資源。
+ `iam` – 允許主體從 IAM 傳遞角色。這是必要的，以便 Amazon Lex V2 具有在其他區域中複寫資源的許可。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "ReplicationPolicyStatement1",
"Effect": "Allow",
"Action": [
"lex:BuildBotLocale",
"lex:ListBotLocales",
"lex:CreateBotAlias",
"lex:UpdateBotAlias",
"lex:DeleteBotAlias",
"lex:DescribeBotAlias",
"lex:CreateBotVersion",
"lex:DeleteBotVersion",
"lex:DescribeBotVersion",
"lex:CreateExport",
"lex:DescribeBot",
"lex:UpdateExport",
"lex:DescribeExport",
"lex:DescribeBotLocale",
"lex:DescribeIntent",
"lex:ListIntents",
"lex:DescribeSlotType",
"lex:ListSlotTypes",
"lex:DescribeSlot",
"lex:ListSlots",
"lex:DescribeCustomVocabulary",
"lex:StartImport",
"lex:DescribeImport",
"lex:CreateBot",
"lex:UpdateBot",
"lex:DeleteBot",
"lex:CreateBotLocale",
"lex:UpdateBotLocale",
"lex:DeleteBotLocale",
"lex:CreateIntent",
"lex:UpdateIntent",
"lex:DeleteIntent",
"lex:CreateSlotType",
"lex:UpdateSlotType",
"lex:DeleteSlotType",
"lex:CreateSlot",
"lex:UpdateSlot",
"lex:DeleteSlot",
"lex:CreateCustomVocabulary",
"lex:UpdateCustomVocabulary",
"lex:DeleteCustomVocabulary",
"lex:DeleteBotChannel",
"lex:ListTagsForResource",
"lex:TagResource",
"lex:UntagResource",
"lex:CreateResourcePolicy",
"lex:DeleteResourcePolicy",
"lex:DescribeResourcePolicy",
"lex:UpdateResourcePolicy"
],
"Resource": [
"arn:aws:lex:*:*:bot/*",
"arn:aws:lex:*:*:bot-alias/*"
]
},
{
"Sid": "ReplicationPolicyStatement2",
"Effect": "Allow",
"Action": [
"lex:CreateUploadUrl",
"lex:ListBots"
],
"Resource": "*"
},
{
"Sid": "ReplicationPolicyStatement3",
"Effect": "Allow",
"Action": [
"iam:PassRole"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"iam:PassedToService": "lexv2.amazonaws.com"
}
}
}
]
}
```
------
## AWS 受管政策：AmazonLexV2BedrockAgentPolicy
Amazon Bedrock 代理程式的 Amazon Lex V2 政策
回應
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Sid": "LexV2TrustPolicy",
"Principal": {
"Service": "lexv2.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "{accountId}"
}
}
}
]
}
```
------
## AWS 受管政策：AmazonLexV2BedrockKnowledgeBasePolicy
Amazon Bedrock 知識庫的 Amazon Lex V2 政策
回應
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Sid": "LexV2TrustPolicy",
"Principal": {
"Service": "lexv2.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "{accountId}"
}
}
}
]
}
```
------
## AWS 受管政策：AmazonLexV2BedrockAgentPolicyInternal
Amazon Bedrock 代理程式的 Amazon Lex V2 內部政策
回應
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Sid": "LexV2InternalTrustPolicy",
"Principal": {
"Service": "lexv2.aws.internal"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "{accountId}"
}
}
}
]
}
```
------
## AWS 受管政策：AmazonLexV2BedrockKnowledgeBasePolicyInternal
Amazon Bedrock 知識庫的 Amazon Lex V2 內部政策
回應
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "LexV2InternalTrustPolicy",
"Effect": "Allow",
"Principal": {
"Service": "lexv2.aws.internal"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "{accountId}"
}
}
}
]
}
```
------
## AWS 受管政策的 Amazon Lex V2 更新
檢視自此服務開始追蹤 Amazon Lex V2 的 AWS 受管政策更新以來的詳細資訊。如需此頁面變更的自動提醒，請訂閱 Amazon Lex V2 [Amazon Lex V2 的文件歷史記錄](doc-history.md)頁面上的 RSS 摘要。
| 變更 | 描述 | Date |
| --- | --- | --- |
| [AmazonLexReplicationPolicy](#security-iam-awsmanpol-AmazonLexReplicationPolicy) – 已更新政策 | Amazon Lex V2 已更新政策，以允許標籤和 ResourceBasedPolicy 的複寫。 | 2025 年 6 月 24 日 |
| [AmazonLexV2BedrockKnowledgeBasePolicyInternal](#security-iam-awsmanpol-AmazonLexV2BedrockKnowledgeBasePolicyInternal) – 新政策 | Amazon Lex V2 新增了允許複寫 Amazon Bedrock 知識庫資源的政策。 | 2024 年 8 月 30 日 |
| [AmazonLexV2BedrockAgentPolicyInternal](#security-iam-awsmanpol-AmazonLexV2BedrockAgentPolicyInternal) – 新政策 | Amazon Lex V2 新增了允許複寫 Amazon Bedrock 代理程式資源的政策。 | 2024 年 8 月 30 日 |
| [AmazonLexV2BedrockKnowledgeBasePolicy](#security-iam-awsmanpol-AmazonLexV2BedrockKnowledgeBasePolicy) – 新政策 | Amazon Lex V2 新增了允許複寫 Amazon Bedrock 知識庫資源的政策。 | 2024 年 8 月 30 日 |
| [AmazonLexV2BedrockAgentPolicy](#security-iam-awsmanpol-AmazonLexV2BedrockAgentPolicy) – 新政策 | Amazon Lex V2 新增了允許複寫 Amazon Bedrock 代理程式資源的政策。 | 2024 年 8 月 30 日 |
| [AmazonLexReadOnly](#security-iam-awsmanpol-AmazonLexReadOnly) – 更新至現有政策 | Amazon Lex V2 新增了新的許可，以允許機器人資源的唯讀存取複本。 | 2024 年 5 月 10 日 |
| [AmazonLexFullAccess](#security-iam-awsmanpol-AmazonLexFullAccess) – 更新現有政策 | Amazon Lex V2 新增了允許將機器人資源複寫至其他區域的許可。 | 2024 年 4 月 16 日 |
| [AmazonLexFullAccess](#security-iam-awsmanpol-AmazonLexFullAccess) – 更新現有政策 | Amazon Lex V2 新增了允許將機器人資源複寫至其他區域的許可。 | 2024 年 1 月 31 日 |
| [AmazonLexReplicationPolicy](#security-iam-awsmanpol-AmazonLexReplicationPolicy) – 新政策 | Amazon Lex V2 新增了新的政策，以允許將機器人資源複寫至其他區域。 | 2024 年 1 月 31 日 |
| [AmazonLexReadOnly](#security-iam-awsmanpol-AmazonLexReadOnly) – 更新至現有政策 | Amazon Lex V2 新增了新的許可，以允許唯讀存取列出自訂詞彙項目。 | 2022 年 11 月 29 日 |
| [AmazonLexFullAccess](#security-iam-awsmanpol-AmazonLexFullAccess) – 更新現有政策 | Amazon Lex V2 新增了新的許可，以允許唯讀存取 Amazon Lex V2 模型建置服務操作。 | 2021 年 8 月 18 日 |
| [AmazonLexReadOnly](#security-iam-awsmanpol-AmazonLexReadOnly) – 更新至現有政策 | Amazon Lex V2 新增了新的許可，以允許唯讀存取 Amazon Lex V2 自動聊天機器人設計工具操作。 | 2021 年 12 月 1 日 |
| [AmazonLexFullAccess](#security-iam-awsmanpol-AmazonLexFullAccess) – 更新現有政策 | Amazon Lex V2 新增了新的許可，以允許唯讀存取 Amazon Lex V2 模型建置服務操作。 | 2021 年 8 月 18 日 |
| [AmazonLexReadOnly](#security-iam-awsmanpol-AmazonLexReadOnly) – 更新至現有政策 | Amazon Lex V2 新增了新的許可，以允許唯讀存取 Amazon Lex V2 模型建置服務操作。 | 2021 年 8 月 18 日 |
| [AmazonLexRunBotsOnly](#security-iam-awsmanpol-AmazonLexRunBotsOnly) – 更新至現有政策 | Amazon Lex V2 新增了新的許可，以允許唯讀存取 Amazon Lex V2 執行期服務操作。 | 2021 年 8 月 18 日 |
| Amazon Lex V2 開始追蹤變更 | Amazon Lex V2 開始追蹤其 AWS 受管政策的變更。 | 2021 年 8 月 18 日 |
# 使用 Amazon Lex V2 的服務連結角色
Amazon Lex V2 使用 AWS Identity and Access Management (IAM)[ 服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role)。服務連結角色是直接連結至 Amazon Lex V2 的唯一 IAM 角色類型。服務連結角色是由 Amazon Lex V2 預先定義，並包含該服務代表您呼叫其他 AWS 服務所需的所有許可。
服務連結角色可讓您更輕鬆地設定 Amazon Lex V2，因為您不必手動新增必要的許可。Amazon Lex V2 會定義其服務連結角色的許可，除非另有定義，否則只有 Amazon Lex V2 可以擔任其角色。定義的許可包括信任政策和許可政策，且該許可政策無法附加至其他 IAM 實體。
如需支援服務連結角色其他服務的資訊，請參閱[可搭配 IAM 運作的 AWS 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)，並尋找 **Service-Linked Role** (服務連結角色) 欄顯示 **Yes** (是) 的服務。選擇具有連結的 **Yes** (是)，以檢視該服務的服務連結角色文件。
您必須設定許可，IAM 實體 (如使用者、群組或角色) 才可建立、編輯或刪除服務連結角色。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[服務連結角色許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)。
您必須先刪除相關資源，才能刪除服務連結角色。這可保護您的 Amazon Lex V2 資源，因為您不會不小心移除存取資源的許可。
**Topics**
+ [為 Amazon Lex V2 建立服務連結角色](#create-slr)
+ [編輯 Amazon Lex V2 的服務連結角色](#edit-slr)
+ [刪除 Amazon Lex V2 的服務連結角色](#delete-slr)
+ [Amazon Lex V2 的服務連結角色許可](#slr-permissions)
+ [Amazon Lex V2 服務連結角色支援的區域](#slr-regions)
## 為 Amazon Lex V2 建立服務連結角色
您不需要手動建立服務連結角色，因為當您在 AWS 管理主控台、AWS CLI 或 AWS API 中執行相關動作 （如需[Amazon Lex V2 的服務連結角色許可](#slr-permissions)詳細資訊，請參閱） 時，Amazon Lex V2 會為您建立服務連結角色。
如果您刪除此服務連結角色，然後需要再次建立一個角色，您可以使用相同的程序在帳戶中建立新的角色。
## 編輯 Amazon Lex V2 的服務連結角色
Amazon Lex V2 不允許您編輯服務連結角色。因為可能有各種實體會參考服務連結角色，所以您無法在建立角色之後變更其名稱。不過，您可以使用 IAM 編輯角色的描述。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[編輯服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role)。
## 刪除 Amazon Lex V2 的服務連結角色
若您不再使用需要服務連結角色的功能或服務，我們建議您刪除該角色。如此一來，您就沒有未主動監控或維護的未使用實體。然而，在手動刪除服務連結角色之前，您必須先清除資源。
**注意**
如果您嘗試刪除資源時，Amazon Lex V2 服務正在使用該角色，則刪除可能會失敗。若此情況發生，請等待數分鐘後並再次嘗試操作。
若要查看在 Amazon Lex V2 中為特定服務連結角色刪除資源的步驟，請參閱 中角色的特定章節[Amazon Lex V2 的服務連結角色許可](#slr-permissions)。
**使用 IAM 手動刪除服務連結角色**
刪除與服務連結角色相關的資源後，請使用 IAM 主控台、AWS CLI 或 AWS API 來刪除角色。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[刪除服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role)。
## Amazon Lex V2 的服務連結角色許可
Amazon Lex V2 使用具有下列字首的服務連結角色。
**Topics**
+ [AWSServiceRoleForLexV2Bots\$1](#slr-bots)
+ [AWSServiceRoleForLexV2Channels\$1](#slr-channels)
+ [AWSServiceRoleForLexV2Replication](#slr-replication)
### AWSServiceRoleForLexV2Bots\$1
AWSServiceRoleForLexV2Bots\$1 角色提供許可，將您的機器人連線至其他必要的服務。此角色包含信任政策，以允許 lexv2.amazonaws.com 服務擔任該角色，並包含執行下列動作的許可。
+ 使用 Amazon Polly 在動作支援的所有 Amazon Lex V2 資源上合成語音。
+ 如果將機器人設定為使用 Amazon Comprehend 情緒分析，請偵測動作支援的所有 Amazon Lex V2 資源上的情緒。
+ 如果將機器人設定為將音訊日誌存放在 S3 儲存貯體中，請將物件放在指定的儲存貯體中。
+ 如果將機器人設定為存放音訊和文字日誌，請在 中建立日誌串流，並將日誌放入指定的日誌群組。
+ 如果將機器人設定為使用 AWS KMS 金鑰來加密資料，請產生特定的資料金鑰。
+ 如果將機器人設定為使用 `KendraSearchIntent`意圖，請查詢對指定 Amazon Kendra 索引的存取。
**建立角色**
Amazon Lex V2 會在您每次建立[機器人](create-bot.md)時，以隨機尾碼建立新的 AWSServiceRoleForLexV2Bots\$1 角色。當您將其他功能新增至機器人時，Amazon Lex V2 會修改角色。例如，如果您[將 Amazon Comprehend 情緒分析新增至機器人](sentiment.md)，Amazon Lex V2 會將`lex:DetectSentiment`動作的許可新增至服務角色。
**刪除 角色**
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/) 開啟 Amazon Lex 主控台。
1. 從左側導覽窗格中，選取**機器人**，然後選擇您要刪除其服務連結角色的機器人。
1. 選取任何版本的機器人。
1. **IAM 許可執行時間角色**位於**版本詳細資訊**中。
1. 返回**機器人**頁面，然後選擇要刪除之機器人旁的選項按鈕。
1. 選取**動作**，然後選擇**刪除**。
1. 請依照[刪除服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role)的步驟刪除 IAM 角色。
### AWSServiceRoleForLexV2Channels\$1
AWSServiceRoleForLexV2Channels\$1 角色提供許可，以列出帳戶中的機器人，並呼叫機器人APIs。此角色包含信任政策，以允許 channels.lexv2.amazonaws.com 服務擔任該角色。如果將機器人設定為使用頻道與簡訊服務通訊，AWSServiceRoleForLexV2Channels\$1 角色許可政策會允許 Amazon Lex V2 完成下列動作。
+ 列出 帳戶中所有機器人的許可。
+ 識別文字、取得工作階段並在指定的機器人別名上放置工作階段許可。
**建立角色**
當您建立頻道整合以在簡訊平台上部署機器人時，Amazon Lex V2 會在您的帳戶中為隨機字尾的每個頻道建立新的服務連結角色。
**刪除 角色**
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/) 開啟 Amazon Lex 主控台。
1. 從左側導覽窗格中，選取**機器人**。
1. 選擇機器人。
1. 在左側導覽窗格中，選擇**部署**下的**頻道整合**。
1. 選取您想要刪除其服務連結角色的頻道。
1. **IAM 許可執行時間角色**位於**一般組態**中
1. 選擇**刪除**，然後再次選擇**刪除**以刪除頻道。
1. 請依照[刪除服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role)的步驟刪除 IAM 角色。
### AWSServiceRoleForLexV2Replication
AWSServiceRoleForLexV2Replication 角色提供在第二個區域中複寫機器人的許可。此角色包含信任政策，以允許 replication.lexv2.amazonaws.com 服務擔任該角色，也包含 [AmazonLexReplicationPolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonLexReplicationPolicy) AWS 受管政策，其允許下列動作的許可。
+ 將機器人 IAM 角色傳遞至複本機器人，以複寫複本機器人的適當許可。
+ 在其他 區域中建立和管理機器人和機器人資源 （版本、別名、意圖、槽、自訂詞彙等）。
**建立角色**
當您為機器人啟用全域彈性時，Amazon Lex V2 會在您的帳戶中建立 AWSServiceRoleForLexV2Replication 服務連結角色。請確定您擁有正確的[許可](gr-permissions.md)，以授予 Amazon Lex V2 服務建立服務連結角色的許可。
**刪除 AWSServiceRoleForLexV2Replication 使用的 Amazon Lex V2 資源，以便您可以刪除角色 AWSServiceRoleForLexV2Replication**
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/) 開啟 Amazon Lex 主控台。
1. 選擇已啟用全域彈性的機器人。
1. 選取**部署**下的**全域彈性**。
1. 選取**停用全域彈性**。
1. 針對已啟用全域彈性的所有機器人重複此程序。
1. 請依照[刪除服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role)的步驟刪除 IAM 角色。
## Amazon Lex V2 服務連結角色支援的區域
Amazon Lex V2 支援在提供服務的所有區域中使用服務連結角色。如需詳細資訊，請參閱 [AWS 區域與端點](https://docs.aws.amazon.com/general/latest/gr/rande.html)。
# 對 Amazon Lex V2 身分和存取進行故障診斷
使用以下資訊來協助您診斷和修正使用 Amazon Lex V2 和 IAM 時可能遇到的常見問題。
**Topics**
+ [我無權在 Amazon Lex V2 中執行動作](#security_iam_troubleshoot-no-permissions)
+ [我未獲得執行 iam:PassRole 的授權](#security_iam_troubleshoot-passrole)
+ [我是管理員，想要允許其他人存取 Amazon Lex V2](#security_iam_troubleshoot-admin-delegate)
+ [將程式設計存取權授予使用者](#security_iam_programmatic_access)
+ [我想要允許 AWS 帳戶以外的人員存取我的 Amazon Lex V2 資源](#security_iam_troubleshoot-cross-account-access)
## 我無權在 Amazon Lex V2 中執行動作
若 AWS 管理主控台 告知您並未獲得執行動作的授權，您必須聯絡您的管理員以取得協助。您的管理員是為您提供簽署憑證的人員。
下列範例錯誤會在`mateojackson` IAM 使用者嘗試使用主控台檢視一個虛構 `my-example-widget` 資源的詳細資訊，但卻無虛構 `lex:GetWidget` 許可時發生。
```
User: arn:aws:iam::123456789012:user/mateojackson is not authorized to perform: lex:GetWidget on resource: my-example-widget
```
在此情況下，Mateo 會請求管理員更新他的政策，允許他使用 `my-example-widget` 動作存取 `lex:GetWidget` 資源。
## 我未獲得執行 iam:PassRole 的授權
如果您收到錯誤，告知您無權執行 `iam:PassRole`動作，您的政策必須更新，以允許您將角色傳遞至 Amazon Lex V2。
有些 AWS 服務 可讓您將現有角色傳遞給該服務，而不是建立新的服務角色或服務連結角色。如需執行此作業，您必須擁有將角色傳遞至該服務的許可。
當名為 的 IAM `marymajor` 使用者嘗試使用主控台在 Amazon Lex V2 中執行動作時，會發生下列範例錯誤。但是，動作請求服務具備服務角色授予的許可。Mary 沒有將角色傳遞給服務的許可。
```
User: arn:aws:iam::123456789012:user/marymajor is not authorized to perform: iam:PassRole
```
在這種情況下，Mary 的政策必須更新，允許她執行 `iam:PassRole` 動作。
如果您需要協助，請聯絡您的 AWS 管理員。您的管理員提供您的簽署憑證。
## 我是管理員，想要允許其他人存取 Amazon Lex V2
若要允許其他人存取 Amazon Lex V2，您必須將許可授予需要存取的人員或應用程式。如果您使用 AWS IAM Identity Center 管理人員和應用程式，您可以將許可集指派給使用者或群組，以定義其存取層級。許可集會自動建立 IAM 政策，並將其指派給與該人員或應用程式相關聯的 IAM 角色。如需詳細資訊，請參閱*AWS IAM Identity Center 《 使用者指南*》中的[許可集](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html)。
如果您不是使用 IAM Identity Center，則必須為需要存取的人員或應用程式建立 IAM 實體 （使用者或角色）。然後，您必須將政策連接到實體，以授予他們 Amazon Lex V2 中的正確許可。授予許可後，請將登入資料提供給使用者或應用程式開發人員。他們會使用這些登入資料來存取 AWS。若要進一步了解如何建立 IAM 使用者、群組、政策和許可，請參閱《IAM **[使用者指南》中的 IAM 身分](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html)[和政策和許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)。
## 將程式設計存取權授予使用者
如需有關如何取得存取金鑰 ID 和私密存取金鑰的資訊，請參閱[《AWS 一般參考》中的了解和取得您的 AWS 登入](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys)資料。
## 我想要允許 AWS 帳戶以外的人員存取我的 Amazon Lex V2 資源
您可以建立一個角色，讓其他帳戶中的使用者或您組織外部的人員存取您的資源。您可以指定要允許哪些信任物件取得該角色。針對支援基於資源的政策或存取控制清單 (ACL) 的服務，您可以使用那些政策來授予人員存取您的資源的許可。
如需進一步了解，請參閱以下內容：
+ 若要了解 Amazon Lex V2 是否支援這些功能，請參閱 [Amazon Lex V2 如何與 IAM 搭配使用](security_iam_service-with-iam.md)。
+ 若要了解如何 AWS 帳戶 在您擁有的 資源之間提供存取權，請參閱《[IAM 使用者指南》中的在您擁有 AWS 帳戶 的另一個 IAM 使用者中提供存取權](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_aws-accounts.html)。 **
+ 若要了解如何將資源的存取權提供給第三方 AWS 帳戶，請參閱《*IAM 使用者指南*》中的[將存取權提供給第三方 AWS 帳戶 擁有](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_third-party.html)。
+ 如需了解如何透過聯合身分提供存取權，請參閱《*IAM 使用者指南*》中的[將存取權提供給在外部進行身分驗證的使用者 (聯合身分)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_federated-users.html)。
+ 如需了解使用角色和資源型政策進行跨帳戶存取之間的差異，請參閱《*IAM 使用者指南*》中的 [IAM 中的跨帳戶資源存取](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html)。