本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 亚马逊 Bedrock 如何 AgentCore 与 IAM 合作
<a name="security_iam_service-with-iam"></a>

在使用 IAM 管理访问权限之前 AgentCore，请了解哪些 IAM 功能可供使用 AgentCore。


| IAM 功能 | AgentCore 支持 | 
| --- | --- | 
|  [Identity-based 政策 ](#security_iam_service-with-iam-id-based-policies)  | 是 | 
|  [Resource-based 政策 ](#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)  | 是 | 
|  [Service-linked 角色 ](#security_iam_service-with-iam-roles-service-linked)  | 是 | 

要详细了解大多数 IAM 功能 AgentCore 以及其他 AWS 服务的工作原理，请参阅 IAM 用户指南[中的与 *IAM 配合使用的*](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)AWS 服务。

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

 **支持基于身份的策略：**是

Identity-based 策略是 JSON 权限策略文档，您可以将其附加到身份，例如 IAM 用户、用户组或角色。这些策略控制用户和角色可在何种条件下对哪些资源执行哪些操作。要了解如何创建基于身份的策略，请参阅《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)。

### Identity-based 的策略示例 AgentCore
<a name="security_iam_service-with-iam-id-based-policies-examples"></a>

要查看 AgentCore 基于身份的政策示例，请参阅 Amazon Bedrock 的[Identity-based 政策示例。 AgentCore ](security_iam_id-based-policy-examples.md)

## Resource-based 内部的政策 AgentCore
<a name="security_iam_service-with-iam-resource-based-policies"></a>

 **支持基于资源的策略：**部分支持

Resource-based 策略是您附加到资源的 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 支持针对代理运行时和网关资源的基于资源的策略。这些策略直接附加到您的资源，并定义哪些委托人可以对这些资源执行操作。

要了解如何为亚马逊基岩资源创建和管理基于 AgentCore 资源的策略，请参阅亚马逊基岩[Resource-based 政策。 AgentCore ](resource-based-policies.md)

### Resource-based 其中的政策示例 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 操作列表，请参阅《*服务授权参考*》 AgentCore[中的 Amazon Bedrock 定义的](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 的[Identity-based 政策示例。 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 资源名称（ARN）](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html)指定资源。对于不支持资源级权限的操作，使用通配符 (\*) 表示该语句适用于所有资源。

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

要查看 AgentCore 资源类型及其 ARN 列表，请参阅*服务授权参考 AgentCore[中的 Amazon Bedrock 定义的](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonbedrockagentcore.html#amazonbedrockagentcore-resources-for-iam-policies)资源。*要了解您可以使用哪些操作来指定每种资源的 ARN，请参阅 Amazon Bedro AgentCore [ ck 定义的](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonbedrockagentcore.html#amazonbedrockagentcore-actions-as-permissions)操作。

要查看 AgentCore 基于身份的政策示例，请参阅 Amazon Bedrock 的[Identity-based 政策示例。 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 用户指南[中的](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html)AWS 全局条件上下文密钥*。

要查看 AgentCore 条件密钥列表，请参阅《*服务授权参考*》 AgentCore[中的 Amazon Bedrock ](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)操作。

以下条件键在使用亚马逊 Bedrock AgentCore 时特别有用：
+  `bedrock-agentcore:InboundJwtClaim/iss`-您可以使用此条件密钥来限制对接受代表最终用户的 JWT 的 API 的访问权限，以使用请求中传递的 JWT 中存在的特定发行者 (iss) 声明值。您可以将此条件密钥应用于`GetWorkloadAccessTokenForJwt`和`CompleteResourceTokenAuth`操作。
+  `bedrock-agentcore:InboundJwtClaim/sub`-您可以使用此条件密钥来限制接受 JWT 的 API 的访问权限，使其使用请求中传递的 JWT 中存在的特定主题（子）声明值。您可以将此条件密钥应用于`GetWorkloadAccessTokenForJwt`和`CompleteResourceTokenAuth`操作。
+  `bedrock-agentcore:InboundJwtClaim/aud`-您可以使用此条件密钥来限制对接受 JWT 的 API 的访问权限，使其与请求中传递的 JWT 中存在的特定受众 (aud) 声明值一起使用。您可以将此条件密钥应用于`GetWorkloadAccessTokenForJwt`和`CompleteResourceTokenAuth`操作。
+  `bedrock-agentcore:userid`-您可以使用此条件密钥来限制对接受静态用户 ID 的 API 的访问权限，使其仅适用于政策声明中定义的用户 ID 值。您可以将此条件密钥应用于`GetWorkloadAccessTokenForUserId`和`CompleteResourceTokenAuth`操作。
+  `bedrock-agentcore:InboundJwtClaim/scope`-您可以使用此条件密钥根据请求中传递的 JWT 中的范围声明来限制访问权限。
+  `bedrock-agentcore:InboundJwtClaim/client_id`-您可以使用此条件密钥来限制接受 JWT 的 API 的访问权限，以使用请求中传递的 JWT 中存在的特定`client_id`声明值。此密钥仅在 JWT 拥有完全`client_id`声明时才可用，而在其他类似声明中传达信息时不可用。您可以将此条件密钥应用于`GetWorkloadAccessTokenForJwt`和`CompleteResourceTokenAuth`操作。

要查看 AgentCore 基于身份的政策示例，请参阅 Amazon Bedrock 的[Identity-based 政策示例。 AgentCore ](security_iam_id-based-policy-examples.md)

有关特定 AgentCore 功能的条件键的详细信息，请参阅以下主题：
+  [将 IAM 条件密钥与亚马逊 Bedrock AgentCore Gateway 结合使用 ](security-gateway-condition-keys.md) — 条件密钥用于`CreateGateway``UpdateGateway``CreateGatewayTarget`、和 `UpdateGatewayTarget` API 操作。
+  [将 IAM 条件密钥用于 AgentCore VPC 设置 ](security-vpc-condition.md) —— AgentCore 运行时 VPC-related 条件密钥、内置工具和网关目标。

## ACL 已加入 AgentCore
<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（策略中的标签）：**部分支持

Attribute-based 访问控制 (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`条件元素中提供标签信息。

如果某个服务对于每种资源类型都支持所有这三个条件键，则对于该服务，该值为**是**。如果某个服务仅对于部分资源类型支持所有这三个条件键，则该值为**部分**。

有关 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)和适用[于 * IAM 的*](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)AWS 服务。

## Cross-service 的主要权限 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 用户指南[中的](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html)创建角色以向 AWS 服务委派权限*。

**警告**  
更改服务角色的权限可能会中断 AgentCore 功能。仅在 AgentCore 提供指导时才编辑服务角色。

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

 **支持服务关联角色：**是

服务相关角色是一种链接到服务的 AWS 服务角色。该服务可以代入代表您执行操作的角色。 Service-linked 角色显示在您的 AWS 账户中并归该服务所有。IAM 管理员可以查看但不能编辑服务关联角色的权限。

有关创建或管理服务相关角色的详细信息，请参阅[能够与 IAM 搭配使用的AWS 服务](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。在表中查找**Service-linked 角色**列`Yes`中包含的服务。选择**是**链接以查看该服务的服务相关角色文档。