亞馬遜肯德拉如何與 IAM - Amazon Kendra
Amazon Kendra 基於身份的政策Amazon Kendra 基於資源的政策存取控制清單 (ACLs)基於 Amazon Kendra 標籤的授權Amazon Kendra 角IAM色

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

亞馬遜肯德拉如何與 IAM

在您用IAM來管理 Amazon Kendra 的存取權限之前，您應該瞭解哪些IAM功能可以搭配 Amazon Kendra 使用。若要深入瞭解 Amazon Kendra 和其他 AWS 服務如何使用IAM，請參閱IAM使用者指南IAM中的可使用AWS 服務。

Amazon Kendra 基於身份的政策

使用以IAM身分識別為基礎的策略，您可以指定允許或拒絕的動作和資源，以及允許或拒絕動作的條件。Amazon Kendra 支援特定動作、資源和條件金鑰。若要瞭解您在JSON策略中使用的所有元素，請參閱《使用IAM者指南》中的《IAMJSON策略元素參考》。

動作

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

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

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

Amazon Kendra 中的政策動作會在動作前使用下列前置詞：kendra:例如，若要授與某人在作業中列出 Amazon Kendra 索引的權限，您可以在他們的政策中包含該kendra:ListIndices動ListIndicesAPI作。政策陳述式必須包含 Action 或 NotAction 元素。Amazon Kendra 會定義自己的一組動作，說明您可以使用此服務執行的任務。

若要在單一陳述式中指定多個動作，請用逗號分隔，如下所示：

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

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

"Action": "kendra:Describe*"

若要查看 Amazon Kendra 動作清單，請參閱IAM使用者指南中的 Amazon Kendra 定義的動作。

資源

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

ResourceJSON原則元素會指定要套用動作的一或多個物件。陳述式必須包含 Resource 或 NotResource 元素。最佳做法是使用其 Amazon 資源名稱 (ARN) 指定資源。您可以針對支援特定資源類型的動作 (稱為資源層級許可) 來這麼做。

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

"Resource": "*"

Amazon Kendra 索引資源具有以下ARN內容：

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

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

例如，若要在陳述式中指定索引，請使用下列索引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 定義的資源。若要了解可以針對每個資源指定哪些動作，請參閱 Amazon Kendra 定義ARN的動作。

條件索引鍵

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

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

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

您也可以在指定條件時使用預留位置變數。例如，只有在IAM使用者名稱標記資源時，您才可以授與IAM使用者存取資源的權限。如需詳細資訊，請參閱《IAM使用指南》中的IAM政策元素：變數和標籤。

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

Amazon Kendra 不提供任何服務特定條件金鑰，但確實支援使用某些全域條件金鑰。若要查看所有 AWS 全域條件索引鍵，請參閱使用指南中的AWS 全域條件內IAM容索引鍵。

範例

若要檢視 Amazon Kendra 身分識別型政策的範例，請參閱。Amazon Kendra 身份識別政策範例

Amazon Kendra 基於資源的政策

Amazon Kendra 不支援以資源為基礎的政策。

存取控制清單 (ACLs)

Amazon Kendra 不支援存取 AWS 服務和資源的存取控制清單 (ACLs)。

基於 Amazon Kendra 標籤的授權

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

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

動作 資源類型 條件索引鍵
CreateDataSource   aws:RequestTag, aws:TagKeys
CreateFaq   aws:RequestTag, aws:TagKeys
CreateIndex   aws:RequestTag, aws:TagKeys
API_ListTagsForResource 資料來源FAQ, 索引  
TagResource 資料來源FAQ, 索引 aws:RequestTag, aws:TagKeys
UntagResource 資料來源FAQ, 索引 aws:TagKeys

如需標記 Amazon Kendra 資源的相關資訊，請參閱標籤。如需根據資源標籤限制資源存取權的識別型政策範例，請參閱。標籤型政策範例如需有關使用標籤限制資源存取權的詳細資訊，請參閱《使用指南》中的「IAM使用標籤控制存取」。

Amazon Kendra 角IAM色

IAM角色是您 AWS 帳戶中具有特定權限的實體。

使用臨時登入資料與 Amazon Kendra

您可以使用臨時認證登入同盟、擔任IAM角色或擔任跨帳戶角色。您可以透過呼叫AssumeRole或之類的 AWS STS API作業來取得臨時安全登入資料GetFederationToken。

Amazon Kendra 支援使用臨時登入資料。

服務角色

此功能可讓服務代表您擔任服務角色。此角色可讓服務存取其他服務中的資源，以代表您完成動作。服務角色會顯示在您的IAM帳戶中，且屬於帳戶所有。這表示IAM系統管理員可以變更此角色的權限。不過，這樣可能會破壞此服務的功能。

Amazon Kendra 支援服務角色。

選擇在 Amazon Kendra IAM 角色

當您建立索引、呼叫BatchPutDocument作業、建立資料來源或建立時FAQ，必須提供 Amazon Kendra 用來代表您存取所需資源的存取角色 Amazon 資源名稱 (ARN)。如果您先前已建立角色，Amazon Kendra 主控台會提供可供您選擇的角色清單。選擇一個允許訪問所需資源的角色非常重要。如需詳細資訊，請參閱IAM 存取角色 Amazon Kendra。