亞馬遜萊克斯如何與 IAM 合作 - Amazon Lex V1

如果您使用的是 Amazon Lex V2,請參閱 Amazon Lex V2 指南

 

如果您使用的是 Amazon Lex V1,我們建議您將機器人升級到 Amazon Lex V2。我們不再向 V1 添加新功能,強烈建議所有新機器人使用 V2。

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

亞馬遜萊克斯如何與 IAM 合作

在您使用 IAM 管理 Amazon Lex 的存取權限之前,請先了解哪些 IAM 功能可與 Amazon Lex 搭配使用。

您可以搭配 Amazon Lex 使用的 IAM 功能
IAM 功能 Amazon Lex 支持

身分型政策

資源型政策

政策動作

政策資源

政策條件索引鍵 (服務特定)

ACL

ABAC(政策中的標籤)

部分

臨時憑證

主體許可

服務角色

服務連結角色

若要深入瞭解 Amazon Lex 和其他 AWS 服務如何搭配大多數 IAM 功能使用,請參閱 IAM 使用者指南中的可與 IAM 搭配使用的AWS 服務

Amazon Lex 基於身份的政策

支援身分型政策

身分型政策是可以連接到身分 (例如 IAM 使用者、使用者群組或角色) 的 JSON 許可政策文件。這些政策可控制身分在何種條件下能對哪些資源執行哪些動作。若要了解如何建立身分類型政策,請參閱《IAM 使用者指南》中的建立 IAM 政策

使用 IAM 身分型政策,您可以指定允許或拒絕的動作和資源,以及在何種條件下允許或拒絕動作。您無法在身分型政策中指定主體,因為這會套用至連接的使用者或角色。如要了解您在 JSON 政策中使用的所有元素,請參閱《IAM 使用者指南》中的 IAM JSON 政策元素參考

Amazon Lex 的基於身份的政策示例

若要檢視 Amazon Lex 以身分識別為基礎的政策範例,請參閱。Amazon Lex 的基於身份的政策示例

Amazon Lex 內的資源型政策

支援以資源基礎的政策

資源型政策是附加到資源的 JSON 政策文件。資源型政策的最常見範例是 IAM 角色信任政策和 Amazon S3 儲存貯體政策。在支援資源型政策的服務中,服務管理員可以使用它們來控制對特定資源的存取權限。對於附加政策的資源,政策會定義指定的主體可以對該資源執行的動作以及在何種條件下執行的動作。您必須在資源型政策中指定主體。主參與者可以包括帳戶、使用者、角色、同盟使用者或。 AWS 服務

如需啟用跨帳戶存取權,您可以指定在其他帳戶內的所有帳戶或 IAM 實體,作為資源型政策的主體。新增跨帳戶主體至資源型政策,只是建立信任關係的一半。當主體和資源位於不同時 AWS 帳戶,受信任帳戶中的 IAM 管理員也必須授與主體實體 (使用者或角色) 權限,才能存取資源。其透過將身分型政策連接到實體來授與許可。不過,如果資源型政策會為相同帳戶中的主體授予存取,這時就不需要額外的身分型政策。如需詳細資訊,請參閱 IAM 使用者指南中的 IAM 中的跨帳戶資源存取

Amazon Lex 的政策行動

支援政策動作

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

JSON 政策的 Action 元素描述您可以用來允許或拒絕政策中存取的動作。原則動作通常與關聯的 AWS API 作業具有相同的名稱。有一些例外狀況,例如沒有相符的 API 操作的僅限許可動作。也有一些作業需要政策中的多個動作。這些額外的動作稱為相依動作

政策會使用動作來授予執行相關聯動作的許可。

若要查看 Amazon Lex 動作清單,請參閱服務授權參考資料由 Amazon Lex 定義的動作。

Amazon Lex 中的政策動作會在動作前使用下列前置詞:

lex

如需在單一陳述式中指定多個動作,請用逗號分隔。

"Action": [ "lex:action1", "lex:action2" ]

您也可以使用萬用字元 (*) 來指定多個動作。例如,若要指定開頭是 Describe 文字的所有動作,請包含以下動作:

"Action": "lex:Describe*"

Amazon Lex 政策資源

支援政策資源

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

Resource JSON 政策元素可指定要套用動作的物件。陳述式必須包含 ResourceNotResource 元素。最佳實務是使用其 Amazon Resource Name (ARN) 來指定資源。您可以針對支援特定資源類型的動作 (稱為資源層級許可) 來這麼做。

對於不支援資源層級許可的動作 (例如列出操作),請使用萬用字元 (*) 來表示陳述式適用於所有資源。

"Resource": "*"

亞 Amazon Lex 機器人資源 ARN 具有以下格式。

arn:aws:lex:${Region}:${Account}:bot:${Bot-Name}

如需 ARN 格式的詳細資訊,請參閱 Amazon 資源名稱 (ARN) 和 AWS 服務命名空間。

例如,若要在陳述式中指定 OrderFlowers 機器人,請使用以下 ARN。

"Resource": "arn:aws:lex:us-east-2:123456789012:bot:OrderFlowers"

若要指定所有屬於特定帳戶的機器人,請使用萬用字元 (*)。

"Resource": "arn:aws:lex:us-east-2:123456789012:bot:*"

某些 Amazon Lex 動作 (例如用於建立資源的動作) 無法在特定資源上執行。在那些情況下,您必須使用萬用字元 (*)。

"Resource": "*"

若要查看 Amazon Lex 資源類型及其 ARN 的清單,請參閱服務授權參考資料中由 Amazon Lex 定義的資源。若要了解可以使用哪些動作指定每個資源的 ARN,請參閱 Amazon Lex 定義的動作

Amazon Lex 的政策條件金鑰

支援服務特定政策條件金鑰

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

Condition 元素 (或 Condition 區塊) 可讓您指定使陳述式生效的條件。Condition 元素是選用項目。您可以建立使用條件運算子的條件運算式 (例如等於或小於),來比對政策中的條件和請求中的值。

若您在陳述式中指定多個 Condition 元素,或是在單一 Condition 元素中指定多個索引鍵, AWS 會使用邏輯 AND 操作評估他們。如果您為單一條件索引鍵指定多個值,請使用邏輯OR運算來 AWS 評估條件。必須符合所有條件,才會授與陳述式的許可。

您也可以在指定條件時使用預留位置變數。例如,您可以只在使用者使用其 IAM 使用者名稱標記時,將存取資源的許可授予該 IAM 使用者。如需更多資訊,請參閱 IAM 使用者指南中的 IAM 政策元素:變數和標籤

AWS 支援全域條件金鑰和服務特定條件金鑰。若要查看所有 AWS 全域條件金鑰,請參閱《IAM 使用者指南》中的AWS 全域條件內容金鑰

若要查看 Amazon Lex 條件金鑰清單,請參閱服務授權參考資料中的 Amazon Lex 的條件金鑰。若要了解可以使用條件金鑰的動作和資源,請參閱 Amazon Lex 定義的動作

下表列出適用於 Amazon Lex 資源的 Amazon Lex 條件金鑰。您可以在 IAM 許可政策中的Condition元素中包含這些金鑰。

Amazon Lex 條件鍵 描述 值類型 權限
lex:associatedIntents

就建立或修改機器人定義時可以使用的一組意圖釐定範圍。

字串陣列

lex:PutBot

lex:associatedSlotTypes

就建立或修改槽類型定義時可以使用的一組槽類型釐定範圍。

字串陣列

lex:PutIntent

lex:ChannelType

就使用者可以建立、取得或刪除的機器人管道關聯類型釐定範圍。

字串

lex:CreateBotChannelAssociation

lex:DeleteBotChannelAssociation

lex:GetBotChannelAssociation

在亞馬遜萊克斯 ACL

支援 ACL

存取控制清單 (ACL) 可控制哪些主體 (帳戶成員、使用者或角色) 擁有存取某資源的許可。ACL 類似於資源型政策,但它們不使用 JSON 政策文件格式。

ABAC 與 Amazon Lex

支援 ABAC (政策中的標籤)

部分

屬性型存取控制 (ABAC) 是一種授權策略,可根據屬性來定義許可。在中 AWS,這些屬性稱為標籤。您可以將標籤附加到 IAM 實體 (使用者或角色) 和許多 AWS 資源。為實體和資源加上標籤是 ABAC 的第一步。您接著要設計 ABAC 政策,允許在主體的標籤與其嘗試存取的資源標籤相符時操作。

ABAC 在成長快速的環境中相當有幫助,並能在政策管理變得繁瑣時提供協助。

如需根據標籤控制存取,請使用 aws:ResourceTag/key-nameaws:RequestTag/key-nameaws:TagKeys 條件索引鍵,在政策的條件元素中,提供標籤資訊。

如果服務支援每個資源類型的全部三個條件金鑰,則對該服務而言,值為 Yes。如果服務僅支援某些資源類型的全部三個條件金鑰,則值為 Partial

如需 ABAC 的詳細資訊,請參閱 IAM 使用者指南中的什麼是 ABAC?。如要查看含有設定 ABAC 步驟的教學課程,請參閱 IAM 使用者指南中的使用屬性型存取控制 (ABAC)

您可以將標籤與特定類型的 Amazon Lex 資源建立關聯以進行授權。若要根據標籤控制存取,請使用 lex:ResourceTag/${TagKey}aws:RequestTag/${TagKey}aws:TagKeys 條件索引鍵,在政策的條件元素中,提供標籤資訊。

如需標記 Amazon Lex 資源的詳細資訊,請參閱標記您的 Amazon Lex 資源

若要檢視身分型政策範例,以根據該資源上的標籤來限制存取資源,請參閱 使用標籤訪問資源

下表列出了以標籤為基礎的存取控制動作和對應的資源類型。每個動作都會根據與對應資源類型相關聯的標籤進行授權。

動作 資源類型 條件索引鍵 備註
CreateBotVersion 機器人 lex:ResourceTag  
DeleteBot 機器人 lex:ResourceTag  
DeleteBotAlias 別名 lex:ResourceTag  
DeleteBotChannelAssociation 通道 lex:ResourceTag  
DeleteBotVersion 機器人 lex:ResourceTag  
DeleteSession 機器人或別名 lex:ResourceTag 當別名設定為 $LATEST 時,使用與機器人相關聯的標籤。與其他別名一起使用時,會使用與指定別名相關聯的標籤。
DeleteUtterances 機器人 lex:ResourceTag  
GetBot 機器人或別名 lex:ResourceTag versionOrAlias 設定為 $LATEST 或數字版本時,則使用與機器人相關聯的標籤。與別名一起使用時,使用與指定別名相關聯的標籤
GetBotAlias 別名 lex:ResourceTag  
GetBotChannelAssociation 頻道 lex:ResourceTag  
GetBotChannelAssociations 頻道 lex:ResourceTag 當別名設為「-」時,使用與機器人相關聯的標籤。當機器人別名已指定時,使用與指定別名相關聯的標籤
GetBotVersions 機器人 lex:ResourceTag  
GetExport 機器人 lex:ResourceTag  
GetSession 機器人或別名 lex:ResourceTag 當別名設定為 $LATEST 時,使用與機器人相關聯的標籤。與其他別名一起使用時,會使用與指定別名相關聯的標籤。
GetUtterancesView 機器人 lex:ResourceTag  
ListTagsForResource 機器人、別名或頻道 lex:ResourceTag  
PostContent 機器人或別名 lex:ResourceTag 當別名設定為 $LATEST 時,使用與機器人相關聯的標籤。與其他別名一起使用時,會使用與指定別名相關聯的標籤。
PostText 機器人或別名 lex:ResourceTag 當別名設定為 $LATEST 時,使用與機器人相關聯的標籤。與其他別名一起使用時,會使用與指定別名相關聯的標籤。
PutBot 機器人 lex:ResourceTag, aws:RequestTag, aws:TagKeys  
PutBotAlias 別名 lex:ResourceTag, aws:RequestTag, aws:TagKeys  
PutSession 機器人或別名 lex:ResourceTag 當別名設定為 $LATEST 時,使用與機器人相關聯的標籤。與其他別名一起使用時,會使用與指定別名相關聯的標籤。
StartImport 機器人 lex:ResourceTag 依賴 PutBot 操作的存取政策。該 StartImport 操作的特定標籤和權限將被忽略。
TagResource 機器人、別名或頻道 lex:ResourceTag, aws:RequestTag, aws:TagKeys  
UntagResource 機器人、別名或頻道 lex:ResourceTag, aws:RequestTag, aws:TagKeys  

透過 Amazon Lex 使用臨時登入資料

支援臨時憑證

當您使用臨時憑據登錄時,某些 AWS 服務 不起作用。如需其他資訊,包括哪些 AWS 服務 與臨時登入資料搭配AWS 服務 使用,請參閱 IAM 使用者指南中的 IAM

如果您使用除了使用者名稱和密碼以外的任何方法登入,則您正在 AWS Management Console 使用臨時認證。例如,當您 AWS 使用公司的單一登入 (SSO) 連結存取時,該程序會自動建立暫時認證。當您以使用者身分登入主控台,然後切換角色時,也會自動建立臨時憑證。如需切換角色的詳細資訊,請參閱 IAM 使用者指南中的切換至角色 (主控台)

您可以使用 AWS CLI 或 AWS API 手動建立臨時登入資料。然後,您可以使用這些臨時登入資料來存取 AWS。 AWS 建議您動態產生臨時登入資料,而非使用長期存取金鑰。如需詳細資訊,請參閱 IAM 中的暫時性安全憑證

您可以搭配聯合使用暫時憑證、擔任 IAM 角色,或是擔任跨帳戶角色。您可以透過呼叫AssumeRoleGetFederation權杖等 AWS STS API 作業來取得臨時安全登入資料。

Amazon Lex 的跨服務主體許可

支援轉寄存取工作階段 (FAS)

當您使用 IAM 使用者或角色在中執行動作時 AWS,您會被視為主體。使用某些服務時,您可能會執行某個動作,進而在不同服務中啟動另一個動作。FAS 會使用主體呼叫的權限 AWS 服務,並結合要求 AWS 服務 向下游服務發出要求。只有當服務收到需要與其 AWS 服務 他資源互動才能完成的請求時,才會發出 FAS 請求。在此情況下,您必須具有執行這兩個動作的許可。如需提出 FAS 請求時的政策詳細資訊,請參閱《轉發存取工作階段》

Amazon Lex 的服務角色

支援服務角色

服務角色是服務擔任的 IAM 角色,可代您執行動作。IAM 管理員可以從 IAM 內建立、修改和刪除服務角色。如需詳細資訊,請參閱 IAM 使用者指南中的建立角色以委派許可給 AWS 服務服務

警告

變更服務角色的許可可可可可能會中斷 Amazon Lex 的功能。只有在 Amazon Lex 提供指導時才編輯服務角色。

在 Amazon Lex 選擇 IAM 角色

Amazon Lex 使用服務鏈接角色來調用 Amazon Comprehend 和 Amazon Polly。它使用您的 AWS Lambda 函數的資源級權限來調用它們。

您必須提供 IAM 角色才能啟用交談標記。如需詳細資訊,請參閱 建立對話日誌的 IAM 角色和政策

Amazon Lex 的服務連結角色

支援服務連結角色

服務連結角色是連結至. AWS 服務服務可以擔任代表您執行動作的角色。服務連結角色會顯示在您的中, AWS 帳戶 且屬於服務所有。IAM 管理員可以檢視,但不能編輯服務連結角色的許可。

如需建立或管理 Amazon Lex 服務連結角色的詳細資訊,請參閱使用 Amazon Lex 的服務連結角色