本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 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)。