跳到主要内容
AI News HubLIVE
站内改写5 分钟阅读

在中心辐射式网络中通过集中检查将 Amazon Bedrock AgentCore Gateway 连接到私有 API

文章摘要

本文介绍了一种经过测试的模式,用于在由中央网络团队拥有所有 VPC 并强制所有 VPC 间流量通过中央防火墙进行双向检查的企业环境中,将 Amazon Bedrock AgentCore Gateway 连接到私有 API 和 MCP 服务器。该模式将 VPC Lattice 资源网关放在网络账户中,使用自管理模式,并通过 AWS RAM 共享资源配置。

来源AWS Machine Learning Blog作者: Puneeth Komaragiri
在中心辐射式网络中通过集中检查将 Amazon Bedrock AgentCore Gateway 连接到私有 API
报告错误

纠错通道尚未开通,可先复制下方文章信息留存。

查看更正说明
直接读正文

许多企业采用集中式网络模型:一个中央网络团队拥有所有虚拟私有云(VPC)和子网,并且 VPC 之间的每个流量都必须双向通过中央防火墙。当代理通过 Amazon Bedrock AgentCore Gateway 调用内部 REST API 和 Model Context Protocol(MCP)服务器时,也必须满足同样的两个要求。Amazon Bedrock AgentCore 是一个用于大规模构建、连接和优化代理的平台,支持任何框架或模型。

本文展示了一种满足这两个要求的模式。网络团队保留对每个子网的所有权,并且 Gateway 与私有 API 和 MCP 服务器之间的流量双向通过中央防火墙。文章涵盖了将 Gateway 用于访问私有目标的 Amazon VPC Lattice 资源网关放置在何处,还涵盖了每个组件的所有权、六项配置决策以及确认该模式有效的检查。

我们在美国东部(弗吉尼亚北部)AWS 区域(us-east-1)构建并测试了该模式,实验室包含 AWS Organizations 中的三个成员账户和一个管理账户。AWS CloudFormation 模板、测试脚本、测试证据和参考资料(地址计划、完整验证检查、故障排除、配额)位于配套存储库中。请将该模式作为指南,并根据您自己的账户架构进行调整。

术语说明

资源网关:Amazon VPC Lattice 进入 VPC 的入口点,在您选择的子网中创建弹性网络接口(ENI)。后端将该地址视为每个连接的源地址。

资源配置:一个 VPC Lattice 对象,用于指定资源网关后面的一个后端(例如内部负载均衡器或 VPC 终端节点 DNS 名称和端口)。您可以通过 AWS Resource Access Manager(AWS RAM)将其共享给其他账户。

托管模式和自管理模式:Gateway 目标的两种私有终端节点选项。在托管模式下,AgentCore 为您创建资源网关。在自管理模式下,您创建资源网关并为目标提供资源配置。

何时使用此模式

当以下所有条件均成立时使用此模式:

网络账户拥有所有 VPC、子网和 AWS Transit Gateway 连接,并通过 AWS RAM 共享应用程序子网。

检查 VPC 中的中央防火墙必须检查进入和离开每个 VPC 的流量。

应用程序团队仅管理自己的资源和安全组。

否则,表 1 中的某个选项可能更合适。

表 1:其他选项更合适的情况

您的环境 | 使用

Gateway 账户可以拥有可访问您工具的子网 | 托管模式

Gateway 与工具之间的流量不需要中央检查 | 自管理模式(如文档所述)

工具可通过公共终端节点访问 | 标准 Gateway 目标

我们还考虑了 AgentCore 拥有的子网中的托管模式、每个工具 VPC 或中央终端节点 VPC 中的资源网关,以及每个工具使用 AWS WAF 的面向互联网的负载均衡器。替代方案说明解释了为什么每种方案在这些约束下都不够理想。

集中检查的设计要求

网络账户拥有每个子网。Gateway 和应用程序账户仅在通过 AWS RAM 共享给它们的子网中构建资源。

VPC 之间的每个流量都双向通过中央防火墙。检查 VPC 中的中央防火墙检查 Gateway 与您的私有 API 和 MCP 服务器之间的流量。

AgentCore Gateway 通过 VPC Lattice 资源网关访问私有目标,而两种私有终端节点模式将其放置在不同位置。托管模式在 Gateway 账户中创建资源网关,这适合该账户可以拥有其运行所在子网的环境。自管理模式(如文档所述)将资源网关放置在可直接访问后端的子网中,这适合不需要在 Gateway 和工具之间进行检查的环境。此环境同时需要这两个条件,因此该模式使用自管理模式并进行一处更改。网络账户拥有资源网关,并将其放置在通过 AWS Transit Gateway 路由的子网中,因此每个请求和响应都经过检查 VPC。

解决方案概述

在网络账户中为资源网关提供其自己的 VPC 和子网。不要共享这些子网,并让后端远离它们。通过中转网关路由它们,以便 VPC 之间的每个请求和响应都通过防火墙。通过 AWS RAM 向 AgentCore 账户共享每个后端的一个资源配置。图 1 显示了账户、VPC 和流量路径。

流量路径

代理位于没有互联网路由的共享子网中,调用 Gateway URL。Gateway 接口终端节点上的私有 DNS 在代理的 VPC 内解析该 URL。

如果附加了 AWS WAF,则评估请求。Gateway 检查其资源策略和入站 JSON Web Token(JWT),然后选择目标和工具。

Gateway 获取工具账户的出站 OAuth 令牌,并通过 VPC Lattice 将请求发送到网络账户中的资源网关。

资源网关子网路由到中转网关,中转网关将流量通过检查 VPC 发送到工具账户的内部 Application Load Balancer(ALB)或 execute-api 终端节点。(通过防火墙。)

ALB 或 Amazon API Gateway 验证令牌并将请求转发到后端。

响应沿相同路径返回。(通过防火墙。)

没有在 AgentCore 账户中附加中转网关的情况下,Gateway 流量如何进入网络账户的 VPC?当您创建目标时,AgentCore 将共享资源配置与其自己的 VPC Lattice 服务网络关联。然后 VPC Lattice 从该服务网络向您 VPC 中资源网关的网络接口传递连接。AWS 运营该跳转,从那里开始,您的路由和防火墙接管。

此模式不做什么。采用前请检查这些限制是否符合您的要求:

无有效载荷检查:从 Gateway 到 ALB 的流量是端到端 TLS,Gateway 会验证证书。防火墙只能看到流元数据和 TLS 服务器名称指示(SNI),而非有效载荷。请求内容位于 Gateway、AWS WAF 和 ALB 日志中。

某些环节跳过防火墙:代理到接口终端节点的环节以及 Gateway 到资源网关的环节不会通过防火墙。AgentCore 向每个身份提供商的令牌请求也不会通过。

工具端没有最终用户身份:使用客户端凭据授权时,到达工具的每个调用都携带 Gateway 的客户端身份。要追踪调用到调用者,请使用 Gateway 应用程序日志中的入站 JWT 声明。

谁拥有什么

表 2:谁创建什么

一次性 | 连接的 ALB 上的新 API | 新 ALB 或工具账户

网络团队 | 资源网关及其 VPC、子网和路由。防火墙规则。从工具 VPC 到中转网关的默认路由(用于 ALB 的签名密钥获取)。Gateway 接口终端节点和策略。AWS RAM 共享 | 无 | 向共享添加一个资源配置。如果范围是新的,则添加防火墙规则

工具团队 | 一个 ALB 证书,其主题备用名称与 AgentCore 团队使用的目标主机名匹配 | 其 ALB 上的监听器规则(含 jwt-validation) | 内部 ALB 和安全组,以及 Gateway 的应用程序客户端(客户端凭据授权,范围如 tools/invoke)

AgentCore 团队 | Gateway、入站授权器、资源策略、可选的 AWS WAF | 每个 API 或 MCP 服务器一个 Gateway 目标 | 一个目标,以及新身份提供商的 OAuth 凭据提供程序

现有目标上的新操作或工具不需要新目标:使用 UpdateGatewayTarget 更新 OpenAPI 规范,或为 MCP 服务器调用 SynchronizeGatewayTargets。存储库的构建顺序列出了每个账户中的步骤以及团队之间传递的值。

先决条件

在 AWS Organizations 中有一个组织,并启用了 AWS RAM 中的资源共享。

AWS Command Line Interface(AWS CLI)2.37.7 或更高版本,或 AWS SDK for Python(Boto3)1.43.106 或更高版本,用于 certificateConfigurations 参数。

对于创建 Gateway 目标的角色:vpc-lattice:GetResourceConfiguration、vpc-lattice:CreateServiceNetworkResourceAssociation、vpc-lattice:GetServiceNetworkResourceAssociation、vpc-lattice:ListServiceNetworkResourceAssociations 和 vpc-lattice:AssociateViaAWSService,以及 bedrock-agentcore 目标操作。如果您的组织目前不使用 VPC Lattice,请检查您的服务控制策略(SCP)。

一个位于中央检查 VPC 中并连接到中转网关的防火墙,且启用了设备模式。

关键设计决策

这些代码片段是实验室模板的摘录,并使用实验室的地址计划。RGW_NET 是资源网关子网(10.0.1.0/24–10.0.3.0/24),TOOL_NET 是工具 VPC(10.12.0.0/16),ALB_NET 是其中的 ALB 子网。

决策 1:将资源网关放在网络账户中的专用 VPC 中

在网络账户中为资源网关创建一个专用 VPC,其子网不共享,且没有中央终端节点或后端。将这些子网路由到中转网关。每个信任区域保留一个资源网关。

ResourceGateway: Type: AWS::VpcLattice::ResourceGateway Properties: Name: hub-resource-gateway VpcIdentifier: !Ref ResourceGatewayVpc SubnetIds: [!Ref RgwSubnetA, !Ref RgwSubnetB, !Ref RgwSubnetC] SecurityGroupIds: [!Ref RgwSg] # egress 443 to application ranges only IpAddressType: IPV4

RgwRouteToTgw: Type: AWS::EC2::Route Properties: RouteTableId: !Ref RgwRouteTable DestinationCidrBlock: 10.0.0.0/8 # internal ranges go to the transit gateway TransitGatewayId: !Ref Tgw

资源网关仅与 AgentCore 一起使用时,每个子网消耗一个 IP 地址,因此小子网就足够了。创建后有两个设置无法更改:Ipv4AddressesPerEni 和 ResourceConfigDnsResolution,因此请提前选择。使用 VPC Lattice 和您的 AgentCore 功能支持的可用区 ID。实验室布局列出了 us-east-1 的可用区 ID。

决策 2:为每个负载均衡器创建一个资源配置,并通过 AWS RAM 共享

将资源配置指向内部 ALB DNS 名称,并与 AgentCore 账户共享。不要以 rcfg- 开头命名,因为 VPC Lattice 保留该前缀。

ToolsResourceConfig: Type: AWS::VpcLattice::ResourceConfiguration Properties: Name: tools-account-a ResourceConfigurationType: SINGLE ResourceGatewayId: !Ref ResourceGateway ProtocolType: TCP PortRanges: ["443"] ResourceConfigurationDefinition: DnsResource: DomainName: internal-tools-alb-1234567890.us-east-1.elb.amazonaws.com IpAddressType: IPV4

ShareToAgentCore: Type: AWS::RAM::ResourceShare Properties: Name: agentcore-resource-configs AllowExternalPrincipals: false Principals: [""] ResourceArns: [!GetAtt ToolsResourceConfig.Arn]

VPC Lattice 将连接传递到资源配置的域。AgentCore 将目标 URL 的主机名(例如 tools.example.internal)作为 SNI 发送,并根据该主机名检查 ALB 证书。证书的主题备用名称必须与该主机名匹配。该主机名不需要在 DNS 中解析。

对于私有 API Gateway REST API,将一个资源配置指向网络账户的 execute-api 接口终端节点。每个 API 的目标使用自己的 URL,并且每个 API 的资源策略必须通过 aws:SourceVpce 允许该终端节点。在我们的测试中,另一个账户中的第二个 API 通过同一资源配置工作,无需更改网络。

决策 3:仅让所需的流量通过防火墙

您的防火墙需要两个有状态允许规则:从资源网关子网到工具 VPC 的端口 443,以及从 ALB 子网到身份提供商主机名的端口 443。基于会话的防火墙……

展开要点与分析

文章情报

工程师中级

要点

  • 该模式适用于网络账户拥有所有子网、中央防火墙必须检查所有 VPC 间流量的环境。
  • 资源网关部署在网络账户的专用 VPC 中,通过中转网关路由,确保每个请求和响应都经过防火墙。
  • 需要自管理模式,并手动创建资源配置,通过 AWS RAM 与 AgentCore 账户共享。
  • 模式存在限制:防火墙看不到有效载荷,某些环节跳过防火墙,且工具端无法获得最终用户身份。

要点与分析由自动化流程生成,可能有误,请结合原始来源核实。