# Amazon Bedrock AgentCore 如何與 IAM 搭配使用
<a name="security_iam_service-with-iam"></a>

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


| IAM 功能 | AgentCore 支援 | 
| --- | --- | 
|  [身分型政策](#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)  | 是 | 

若要全面了解 AgentCore 和其他 AWS 服務如何與大多數 IAM 功能搭配使用，請參閱《[AWS IAM 使用者指南》中的與 IAM 搭配使用的 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。 **

## AgentCore 的身分型政策
<a name="security_iam_service-with-iam-id-based-policies"></a>

 **支援身分型政策：**是

身分型政策是可以附加到身分 (例如 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)。

### AgentCore 的身分型政策範例
<a name="security_iam_service-with-iam-id-based-policies-examples"></a>

若要檢視 AgentCore 身分型政策的範例，請參閱 [Amazon Bedrock AgentCore 的身分型政策範例](security_iam_id-based-policy-examples.md)。

## AgentCore 中的資源型政策
<a name="security_iam_service-with-iam-resource-based-policies"></a>

 **支援資源型政策：**部分

資源型政策是附加到資源的 JSON 政策文件。資源型政策的最常見範例是 IAM *角色信任政策*和 Amazon S3 *儲存貯體政策*。在支援資源型政策的服務中，服務管理員可以使用它們來控制對特定資源的存取權限。對於附加政策的資源，政策會定義指定的主體可以對該資源執行的動作以及在何種條件下執行的動作。您必須在資源型政策中[指定主體](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html)。委託人可以包括帳戶、使用者、角色、聯合身分使用者 AWS 或服務。

如需啟用跨帳戶存取權，您可以在其他帳戶內指定所有帳戶或 IAM 實體作為資源型政策的主體。如需詳細資訊，請參閱《*IAM 使用者指南*》中的 [IAM 中的快帳戶資源存取](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html)。

Amazon Bedrock AgentCore 支援 Agent Runtime 和 Gateway 資源的資源型政策。這些政策會直接連接到您的 資源，並定義哪些委託人可以對其執行動作。

若要了解如何建立和管理 Amazon Bedrock AgentCore 資源的資源型政策，請參閱 [Amazon Bedrock AgentCore 的資源型政策](resource-based-policies.md)。

### AgentCore 中的資源型政策範例
<a name="security_iam_service-with-iam-resource-based-policies-examples"></a>

若要檢視 AgentCore 資源型政策的範例，請參閱[常見使用案例和範例](resource-based-policies.md#resource-based-policies-examples)。

## AgentCore 的政策動作
<a name="security_iam_service-with-iam-id-based-policies-actions"></a>

 **支援政策動作：**是

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

JSON 政策的 `Action` 元素描述您可以用來允許或拒絕政策中存取的動作。政策會使用動作來授予執行相關聯動作的許可。

若要查看 AgentCore 動作清單，請參閱*《服務授權參考*》中的 [Amazon Bedrock AgentCore 定義的動作](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonbedrockagentcore.html#amazonbedrockagentcore-actions-as-permissions)。

AgentCore 中的政策動作在動作之前使用以下字首：

```
bedrock-agentcore
```

若要在單一陳述式中指定多個動作，請用逗號分隔。

```
"Action": [
      "bedrock-agentcore:action1",
      "bedrock-agentcore:action2"
         ]
```

若要檢視 AgentCore 身分型政策的範例，請參閱 [Amazon Bedrock AgentCore 的身分型政策範例](security_iam_id-based-policy-examples.md)。

## AgentCore 的政策資源
<a name="security_iam_service-with-iam-id-based-policies-resources"></a>

 **支援政策資源：**是

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

`Resource` JSON 政策元素可指定要套用動作的物件。最佳實務是使用其 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 來指定資源。對於不支援資源層級許可的動作，請使用萬用字元 (\*) 表示陳述式適用於所有資源。

```
"Resource": "*"
```

若要查看 AgentCore 資源類型及其 ARNs，請參閱*《服務授權參考*》中的 [Amazon Bedrock AgentCore 定義的資源](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonbedrockagentcore.html#amazonbedrockagentcore-resources-for-iam-policies)。若要了解您可以使用哪些動作指定每個資源的 ARN，請參閱 [Amazon Bedrock AgentCore 定義的動作](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonbedrockagentcore.html#amazonbedrockagentcore-actions-as-permissions)。

若要檢視 AgentCore 身分型政策的範例，請參閱 [Amazon Bedrock AgentCore 的身分型政策範例](security_iam_id-based-policy-examples.md)。

## AgentCore 的政策條件索引鍵
<a name="security_iam_service-with-iam-id-based-policies-conditionkeys"></a>

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

管理員可以使用 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)。

若要查看 AgentCore 條件金鑰清單，請參閱*《服務授權參考*》中的 [Amazon Bedrock AgentCore 的條件金鑰](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonbedrockagentcore.html#amazonbedrockagentcore-policy-keys)。若要了解您可以使用條件金鑰的動作和資源，請參閱 [Amazon Bedrock AgentCore 定義的動作](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonbedrockagentcore.html#amazonbedrockagentcore-actions-as-permissions)。

使用 Amazon Bedrock AgentCore 時，下列條件索引鍵特別有用：
+  `bedrock-agentcore:InboundJwtClaim/iss` - 您可以使用此條件金鑰來限制存取 APIAPIs 接受代表最終使用者的 JWT，以使用在請求中傳遞的 JWT 中存在的特定發行者 (iss) 宣告值。您可以將此條件金鑰套用至 `GetWorkloadAccessTokenForJwt`和 `CompleteResourceTokenAuth`操作。
+  `bedrock-agentcore:InboundJwtClaim/sub` - 您可以使用此條件金鑰來限制存取接受 JWT APIs，以使用在請求中傳遞的 JWT 中存在的特定主體 （子） 宣告值。您可以將此條件金鑰套用至 `GetWorkloadAccessTokenForJwt`和 `CompleteResourceTokenAuth`操作。
+  `bedrock-agentcore:InboundJwtClaim/aud` - 您可以使用此條件金鑰來限制存取接受 JWT APIs，以處理在請求中傳遞的 JWT 中存在的特定對象 (aud) 宣告值。您可以將此條件金鑰套用至 `GetWorkloadAccessTokenForJwt`和 `CompleteResourceTokenAuth`操作。
+  `bedrock-agentcore:userid` - 您可以使用此條件金鑰來限制對接受靜態使用者 ID APIs 的存取，只能使用政策陳述式中定義的使用者 ID 值。您可以將此條件金鑰套用至 `GetWorkloadAccessTokenForUserId`和 `CompleteResourceTokenAuth`操作。
+  `bedrock-agentcore:InboundJwtClaim/scope` - 您可以使用此條件金鑰，根據請求中傳遞的 JWT 中的範圍宣告來限制存取。
+  `bedrock-agentcore:InboundJwtClaim/client_id` - 您可以使用此條件金鑰來限制存取接受 JWT APIs，以使用在請求中傳遞的 JWT 中存在的特定`client_id`宣告值。此金鑰只有在 JWT 完全具有`client_id`宣告時才可用，在其他類似宣告中傳達資訊時則無法使用。您可以將此條件金鑰套用至 `GetWorkloadAccessTokenForJwt`和 `CompleteResourceTokenAuth`操作。

若要檢視 AgentCore 身分型政策的範例，請參閱 [Amazon Bedrock AgentCore 的身分型政策範例](security_iam_id-based-policy-examples.md)。

如需特定 AgentCore 功能之條件索引鍵的詳細資訊，請參閱下列主題：
+  [搭配 Amazon Bedrock AgentCore Gateway 使用 IAM 條件金鑰](security-gateway-condition-keys.md) – `CreateGateway`、`CreateGatewayTarget`、 `UpdateGateway`和 `UpdateGatewayTarget` API 操作的條件金鑰。
+  [搭配 AgentCore VPC 設定使用 IAM 條件金鑰](security-vpc-condition.md) – AgentCore 執行時間、內建工具和閘道目標的 VPC 相關條件金鑰。

## AgentCore ACLs
<a name="security_iam_service-with-iam-acls"></a>

 **支援 ACL：**否

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

## ABAC 搭配 AgentCore
<a name="security_iam_service-with-iam-tags"></a>

 **支援 ABAC (政策中的標籤)：**部分

屬性型存取控制 (ABAC) 是一種授權策略，根據稱為標籤的屬性定義許可權。您可以將標籤連接至 IAM 實體 AWS 和資源，然後設計 ABAC 政策，以便在委託人的標籤符合資源上的標籤時允許操作。

若要根據標籤控制存取，您可以使用 、 `aws:ResourceTag/key-name` `aws:RequestTag/key-name` 或 [條件索引鍵，在政策的條件元素](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)中提供標籤資訊。 `aws:TagKeys`

如果服務支援每個資源類型的全部三個條件金鑰，則對該服務而言，值為 **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)。

## 搭配 AgentCore 使用臨時登入資料
<a name="security_iam_service-with-iam-roles-tempcreds"></a>

 **支援臨時憑證：**是

臨時登入資料提供對 AWS 資源的短期存取，並在您使用聯合或切換角色時自動建立。 AWS 建議您動態產生臨時登入資料，而不是使用長期存取金鑰。如需詳細資訊，請參閱《[IAM 使用者指南》中的 IAM 中的臨時安全登入](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html)資料和[AWS 與 IAM 搭配使用的 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。 **

## AgentCore 的跨服務主體許可
<a name="security_iam_service-with-iam-principal-permissions"></a>

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

轉送存取工作階段 (FAS) 使用呼叫 AWS 服務的委託人許可，結合 請求 AWS 服務向下游服務提出請求。如需提出 FAS 請求時的政策詳細資訊，請參閱[轉發存取工作階段](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html)。

## AgentCore 的服務角色
<a name="security_iam_service-with-iam-roles-service"></a>

 **支援服務角色：**是

服務角色是服務擔任的 [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)。

**警告**  
變更服務角色的許可可能會中斷 AgentCore 功能。只有在 AgentCore 提供指引時，才能編輯服務角色。

## AgentCore 的服務連結角色
<a name="security_iam_service-with-iam-roles-service-linked"></a>

 **支援服務連結角色：**是

服務連結角色是連結至 服務的一種 AWS 服務角色。服務可以擔任代表您執行動作的角色。服務連結角色會顯示在您的帳戶中 AWS ，並由服務擁有。IAM 管理員可以檢視，但不能編輯服務連結角色的許可。

如需建立或管理服務連結角色的詳細資訊，請參閱[可搭配 IAM 運作的AWS 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。在資料表中尋找服務，其中包含**服務連結角色**欄中的 `Yes`。選擇**是**連結，以檢視該服務的服務連結角色文件。