Amazon MSK 如何搭配 IAM 運作

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

Amazon MSK 身分型政策

使用 IAM 身分型政策，您可以指定允許或拒絕的動作和資源，以及在何種條件下允許或拒絕動作。Amazon MSK 支援特定動作、資源和條件鍵。若要了解您在 JSON 政策中使用的所有元素，請參閱 IAM 使用者指南中的 JSON 政策元素參考。

動作

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

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

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

Amazon MSK 中的政策動作會在動作之前使用下列前綴：kafka:。例如，若要授予某人使用 Amazon MSK DescribeCluster API 操作描述 MSK 叢集的許可，請在其政策中包含 kafka:DescribeCluster 動作。政策陳述式必須包含 Action 或 NotAction 元素。Amazon MSK 會定義自己的一組動作，描述您可以使用此服務執行的任務。

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

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

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

"Action": "kafka:Describe*"

若要查看 Amazon MSK 動作的清單，請參閱《IAM 使用者指南》中的 Amazon Managed Streaming for Apache Kafka 的動作、資源和條件鍵。

資源

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

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

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

"Resource": "*"

Amazon MSK 執行個體資源具有以下 ARN：

arn:${Partition}:kafka:${Region}:${Account}:cluster/${ClusterName}/${UUID}

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

例如，若要在陳述式中指定 CustomerMessages 執行個體，請使用以下 ARN：

"Resource": "arn:aws:kafka:us-east-1:123456789012:cluster/CustomerMessages/abcd1234-abcd-dcba-4321-a1b2abcd9f9f-2"

若要指定屬於特定帳戶的所有執行個體，請使用萬用字元 (*)：

"Resource": "arn:aws:kafka:us-east-1:123456789012:cluster/*"

有些 Amazon MSK 動作無法對特定資源執行，例如用來建立資源的動作。在這些情況下，您必須使用萬用字元 (*)。

"Resource": "*"

若要在單一陳述式中指定多項資源，請使用逗號分隔 ARN。

"Resource": ["resource1", "resource2"]

若要查看 Amazon MSK 資源類型及其 ARN 的清單，請參閱《IAM 使用者指南》中的 Amazon Managed Streaming for Apache Kafka 定義的資源。若要了解您可以使用哪些動作指定每個資源的 ARN，請參閱 Amazon Managed Streaming for Apache Kafka 定義的動作。

條件索引鍵

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

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

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

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

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

Amazon MSK 會定義自己的一組條件鍵，也支援使用一些全域條件鍵。若要查看所有 AWS 全域條件金鑰，請參閱 IAM 使用者指南中的AWS 全域條件內容金鑰。

若要查看 Amazon MSK 條件鍵的清單，請參閱《IAM 使用者指南》中的 Amazon Managed Streaming for Apache Kafka 的條件鍵。若要了解您可以搭配哪些動作和資源使用條件鍵，請參閱 Amazon Managed Streaming for Apache Kafka 定義的動作。

範例

若要檢視 Amazon MSK 身分型政策的範例，請參閱 Amazon MSK 身分型政策範例。

Amazon MSK 資源型政策

Amazon MSK 支援將叢集政策 (也稱為資源型政策) 與 Amazon MSK 叢集搭配使用。您可以使用叢集政策定義哪些 IAM 主體具有跨帳戶許可，可以設定 Amazon MSK 叢集的私有連線。與 IAM 用戶端身分驗證搭配使用時，您還可以使用叢集政策為連線的用戶端精細定義 Kafka 資料平面的許可。

若要檢視如何設定叢集政策的範例，請參閱步驟 2：將叢集政策連接至 MSK 叢集。

AWS 受管理政策

基於 Amazon MSK 標籤的授權

您可以將標籤連接至 Amazon MSK 叢集。若要根據標籤控制存取，請使用 kafka:ResourceTag/key-name、aws:RequestTag/key-name 或 aws:TagKeys 條件鍵，在政策的條件元素中，提供標籤資訊。如需有關標記 Amazon MSK 資源的詳細資訊，請參閱標記 Amazon MSK 叢集。

若要檢視身分型政策範例，了解如何根據標籤上的叢集來限制該叢集的存取權，請參閱 根據標籤存取 Amazon MSK 叢集。

Amazon MSK IAM 角色

IAM 角色是您 Amazon Web Services 帳戶中具備特定許可的實體。

將暫時憑證與 Amazon MSK 搭配使用

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

Amazon MSK 支援使用暫時憑證。

服務連結角色

服務連結角色允許 Amazon Web Services 存取其他服務中的資源，以代您完成動作。服務連結角色會顯示在您的 IAM 帳戶中，並由該服務所擁有。 管理員可以檢視，但不能編輯服務連結角色的許可。

Amazon MSK 支援服務連結角色。如需有關建立或管理 Amazon MSK 服務連結角色的詳細資訊，請參閱使用 Amazon MSK 的服務連結角色。