View a markdown version of this page

Amazon Bedrock 如何 AgentCore 与 IAM 合作 - Amazon Bedrock AgentCore
Identity-based 的政策 AgentCoreResource-based 内在的政策 AgentCore的政策行动 AgentCore的政策资源 AgentCoreAgentCore 的策略条件键输入的 ACL AgentCoreABAC with AgentCore将临时证书与 AgentCoreCross-service 的委托人权限 AgentCore的服务角色 AgentCoreService-linked 的角色 AgentCore

Amazon Bedrock 如何 AgentCore 与 IAM 合作

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

IAM 功能 AgentCore 支持

Identity-based 政策

是

Resource-based 政策

部分

策略操作

是

策略资源

是

策略条件键

是

ACL

否

ABAC（策略中的标签）

部分

临时凭证

是

主体权限

是

服务角色

是

Service-linked 角色

是

要全面了解 AgentCore 以及其他 AWS 服务如何与大多数 IAM 功能配合使用，请参阅 IAM 用户指南中的与 IAM 配合使用的AWS 服务。

Identity-based 的政策 AgentCore

支持基于身份的策略：是

Identity-based 策略是您可以附加到身份（例如 IAM 用户、用户组或角色）的 JSON 权限策略文档。这些策略控制用户和角色可在何种条件下对哪些资源执行哪些操作。要了解如何创建基于身份的策略，请参阅《IAM 用户指南》中的使用客户管理型策略定义自定义 IAM 权限。

通过使用 IAM 基于身份的策略，您可以指定允许或拒绝的操作和资源以及允许或拒绝操作的条件。要了解可在 JSON 策略中使用的所有元素，请参阅《IAM 用户指南》中的 IAM JSON 策略元素引用。

Identity-based 的策略示例 AgentCore

要查看 AgentCore 基于身份的策略示例，请参阅 Amazon Bedrock 的Identity-based 策略示例。 AgentCore

Resource-based 内在的政策 AgentCore

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

Resource-based 策略是您附加到资源的 JSON 策略文档。基于资源的策略的示例包括 IAM 角色信任策略和 Amazon S3 存储桶策略。在支持基于资源的策略的服务中，服务管理员可以使用它们来控制对特定资源的访问。对于在其中附加策略的资源，策略定义指定主体可以对该资源执行哪些操作以及在什么条件下执行。您必须在基于资源的策略中指定主体。委托人可以包括账户、用户、角色、联合用户或 AWS 服务。

要启用跨账户访问，您可以将整个账户或其它账户中的 IAM 实体指定为基于资源的策略中的主体。有关更多信息，请参阅《IAM 用户指南》中的 IAM 中的跨账户资源访问。

Amazon Bedrock AgentCore 支持针对代理运行时和网关资源的基于资源的策略。这些策略直接附加到您的资源上，并定义了哪些委托人可以对其执行操作。

要了解如何为 Amazon Bedrock 资源创建和管理基于 AgentCore 资源的策略，请参阅 Amaz on Bedrock Resource-based 政策。 AgentCore

Resource-based 其中的政策示例 AgentCore

要查看 AgentCore 基于资源的策略的示例，请参阅常见用例和示例。

的政策行动 AgentCore

支持策略操作：是

管理员可以使用 AWS JSON 策略来指定谁有权访问什么。也就是说，哪位委托人可以在什么资源上以及在什么条件下执行操作。

JSON 策略的 Action 元素描述可用于在策略中允许或拒绝访问的操作。在策略中包含操作以授予执行关联操作的权限。

要查看 AgentCore 操作列表，请参阅《服务授权参考》 AgentCore中的 Amazon Bedrock 定义的操作。

正在执行的策略操作在操作前 AgentCore 使用以下前缀：

bedrock-agentcore

要在单个语句中指定多项操作，请使用逗号将它们隔开。

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

要查看 AgentCore 基于身份的策略示例，请参阅 Amazon Bedrock 的Identity-based 策略示例。 AgentCore

的政策资源 AgentCore

支持策略资源：是

管理员可以使用 AWS JSON 策略来指定谁有权访问什么。也就是说，哪位委托人可以在什么资源上以及在什么条件下执行操作。

Resource JSON 策略元素指定要向其应用操作的一个或多个对象。作为最佳实践，请使用其 Amazon 资源名称（ARN）指定资源。对于不支持资源级权限的操作，请使用通配符 (*) 表示该语句适用于所有资源。

"Resource": "*"

要查看 AgentCore 资源类型及其 ARN 的列表，请参阅《服务授权参考》 AgentCore中的 Amazon Bedrock 定义的资源。要了解您可以使用哪些操作来指定每种资源的 ARN，请参阅 A mazon Bedrock 定义的操作。 AgentCore

要查看 AgentCore 基于身份的策略示例，请参阅 Amazon Bedrock 的Identity-based 策略示例。 AgentCore

AgentCore 的策略条件键

支持特定于服务的策略条件键：是

管理员可以使用 AWS JSON 策略来指定谁有权访问什么。也就是说，哪位委托人可以在什么资源上以及在什么条件下执行操作。

Condition 元素根据定义的条件指定语句何时执行。您可以使用条件运算符（例如等于或小于）创建条件表达式，将策略中的条件与请求中的值进行匹配。要查看所有 AWS 全局条件键，请参阅 IAM 用户指南中的AWS 全局条件上下文密钥。

要查看 AgentCore 条件密钥列表，请参阅《服务授权参考》 AgentCore中的 Amazon Bedrock 条件密钥。要了解您可以使用哪些操作和资源使用条件键，请参阅 Amazon Bedrock AgentCore 定义的操作。

使用 Amazon 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

有关特定 AgentCore 权能的条件键的详细信息，请参阅以下主题：

输入的 ACL AgentCore

支持 ACL：否

访问控制列表（ACL）控制哪些主体（账户成员、用户或角色）有权访问资源。ACL 与基于资源的策略类似，但它们不使用 JSON 策略文档格式。

ABAC with AgentCore

支持 ABAC（策略中的标签）：部分支持

Attribute-based 访问控制 (ABAC) 是一种授权策略，它根据称为标签的属性来定义权限。您可以将标签附加到 IAM 实体和 AWS 资源，然后设计 ABAC 策略以允许在委托人的标签与资源上的标签匹配时进行操作。

要根据标签控制访问权限，您可以使用aws:ResourceTag/key-nameaws:RequestTag/key-name、或条件键在策略的aws:TagKeys条件元素中提供标签信息。

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

有关 ABAC 的更多信息，请参阅《IAM 用户指南》中的使用 ABAC 授权定义权限。要查看设置 ABAC 步骤的教程，请参阅《IAM 用户指南》中的使用基于属性的访问权限控制（ABAC）。

将临时证书与 AgentCore

支持临时凭证：是

临时证书提供对 AWS 资源的短期访问权限，并且是在您使用联合身份或切换角色时自动创建的。 AWS 建议您动态生成临时证书，而不是使用长期访问密钥。有关更多信息，请参阅 IAM 用户指南中的 IAM 中的临时安全证书和与 IAM 配合使用的AWS 服务。

Cross-service 的委托人权限 AgentCore

支持转发访问会话（FAS）：是

转发访问会话 (FAS) 使用调用 AWS 服务的委托人的权限以及请求 AWS 服务的权限，向下游服务发出请求。有关发出 FAS 请求时的策略详情，请参阅转发访问会话。

的服务角色 AgentCore

支持服务角色：是

服务角色是由一项服务担任、代表您执行操作的 IAM 角色。IAM 管理员可以在 IAM 中创建、修改和删除服务角色。有关更多信息，请参阅 IAM 用户指南中的创建角色以向 AWS 服务委派权限。

警告

更改服务角色的权限可能会中断 AgentCore 功能。只有在 AgentCore 提供操作指导时才编辑服务角色。

Service-linked 的角色 AgentCore

支持服务关联角色：是

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

有关创建或管理服务相关角色的详细信息，请参阅能够与 IAM 搭配使用的AWS 服务。在表中查找Service-linked 角色列Yes中包含的服务。选择是链接以查看该服务的服务相关角色文档。