AWS发布AgentCore网关接入私有API的轮辐式集中检查架构
摘要:AWS 发布并实测了 Amazon Bedrock AgentCore Gateway 接入私有 API 的集中网络方案:网络账号持有 VPC Lattice Resource Gateway,经 Transit Gateway 与检查 VPC 让请求、回包双向经过防火墙,再通过 RAM 共享后端资源配置。文章提供 CloudFormation、测试脚本和 14 项验证清单;但实测仅覆盖 us-east-1、AWS Network Firewall 且无源 NAT,TLS 载荷不可见,部分令牌与 Agent 链路也不经防火墙,不能把网络检查等同于全链路内容审计。
架构结论
AWS此次给出的不是一项新的 AgentCore 网络功能,而是一套已在实验室验证的参考架构:在 Amazon Bedrock AgentCore Gateway 的 self-managed 私有端点模式中,把 VPC Lattice Resource Gateway 移入网络账号的专属 VPC,再利用 Transit Gateway 和检查 VPC,让访问工具后端的请求与回包都经过中央防火墙。
这一改动解决了大型企业常见的账号边界问题:网络团队可以继续拥有全部 VPC、子网和路由,应用团队只管理 ALB、API、身份提供方及安全组,而 AgentCore 团队无需获得工具 VPC 的直接管理权。
请求路径与工作机制
一次私有工具调用按以下顺序完成:
- 智能体运行在通过 AWS RAM 共享、且没有互联网出口的子网中,通过 Gateway Interface Endpoint 的私有 DNS 解析 Gateway URL。
- 可选的 AWS WAF 检查工具调用参数;Gateway 随后校验资源策略和入站 JWT,再选择目标工具。
- Gateway 使用工具账号的 OAuth 客户端凭据获取访问令牌,并经 VPC Lattice 将连接送往共享的 Resource Configuration 对应的 Resource Gateway。该跳由 AWS 托管,但不会经过企业的中央防火墙。
- Resource Gateway 的弹性网络接口位于网络账号专属子网,默认路由指向 Transit Gateway;TGW 以 appliance mode 将流量送入检查 VPC,防火墙再把请求转发到工具账号的内部 ALB 或私有
execute-api端点。 - ALB 使用
jwt-validation动作校验 JWT;私有 API Gateway 则使用 authorizer。令牌通过后,请求才进入实际后端。 - 响应沿原路返回,因此资源网关到工具后端的请求和回包都会触发防火墙状态检查。
这里有一个容易被忽略的边界:AgentCore Gateway 到 Resource Gateway 的第一跳由 VPC Lattice 服务网络直接建立,不经过 Transit Gateway,也不经过中央防火墙。真正被集中检查的是 Resource Gateway 到工具后端的跨 VPC 流量。
账号与资产责任划分
| 责任方 | 核心资产 | 主要控制点 | |---|---|---| | 网络团队 | Resource Gateway、专属 VPC、子网、路由、防火墙、Gateway Interface Endpoint、AWS RAM 共享 | 决定流量是否进入检查 VPC,并限制可达网段 | | 工具团队 | 内部 ALB、API、证书、安全组、身份提供方、OAuth 应用客户端 | 校验 Gateway 身份与 scope,隔离后端服务 | | AgentCore 团队 | Gateway、入站 authorizer、资源策略、可选 WAF、Gateway Target、OAuth Credential Provider | 固定目标与令牌,关联共享的 Resource Configuration |
六个关键设计决策
1. 每个信任域使用独立 Resource Gateway VPC
Resource Gateway 不应与工具后端或中央终端服务混部。AWS建议为每个信任域创建独立 VPC 和子网,并保持一个信任域一个 Resource Gateway。这样既避免共享故障域,也能让网络策略按业务域扩展。
仅供 AgentCore 使用时,Resource Gateway 每个子网消耗一个 IP 地址,小型子网即可承载。不过 Ipv4AddressesPerENI 和 ResourceConfigDnsResolution 创建后不能修改,必须在部署前确定。可用区也应同时满足 VPC Lattice 与相关 AgentCore 功能的约束。
2. 每个后端负载均衡器创建一个 Resource Configuration
Resource Configuration 指向内部 ALB 的 DNS 名称和 443 端口,再通过 AWS RAM 分享给 AgentCore 账号。名称不能使用 VPC Lattice 保留的 rcfg- 前缀。
Gateway 发送目标主机名作为 TLS SNI,因此 ALB 证书的 SAN 必须匹配该主机名;该主机名本身不必能够被 DNS 解析。私有 API Gateway REST API 的做法是让 Resource Configuration 指向网络账号中的 execute-api Interface Endpoint,再以 aws:SourceVpce 限制该端点可访问的 API。
3. 防火墙只放行必要的有状态流量
核心规则只有两类:从 Resource Gateway 子网到工具 VPC 的 443 流量,以及 ALB 子网到身份提供方 JWKS 端点的 443 流量。AWS Network Firewall 使用严格规则顺序时,第一条规则允许工具调用,第二条规则根据 TLS SNI 放行签名密钥获取。
如果缺少 JWKS 规则,实验中 ALB 会返回 HTTP 500,智能体侧只能看到 MCP invocation failed。这条看似细小的出站规则,实际上承担了令牌校验链的闭环。
4. 在工具边界再次验证令牌
内部 ALB 的默认动作应设为固定 404,并仅在转发规则上配置 jwt-validation。校验项至少应包含 issuer、JWKS、tools/invoke scope,并把 client_id 固定为 Gateway 的应用客户端。测试中,无令牌、错误身份提供方的令牌以及同一用户池中其他客户端的令牌,均在调用后端前返回 HTTP 401。
私有 API Gateway 不能把 API key 当作调用者身份;每个方法仍需配置 authorizer,并结合端点策略限制可访问的 API 和账号。
5. 用 SCP 阻止绕过共享资源
AWS RAM 的托管权限还会赋予接收账号创建 VPC Endpoint 的能力,AgentCore 账号理论上可能绕过既定资源网关,自行创建指向同一后端的资源端点。客户托管权限无法简单删除这一能力,因为 Gateway Target 又依赖 vpc-lattice:AssociateViaAWSService。
可行的控制是使用 SCP:拒绝针对共享 Resource Configuration 执行 ec2:CreateVpcEndpoint,并在 aws:ViaAWSService 不为 true 时拒绝自行创建 Service Network Resource Association。实验中,违规端点和关联均被拒绝,而新的 Gateway Target 仍能进入 READY。需要注意的是,SCP 不作用于组织管理账号,因此不应把 AgentCore 部署在管理账号中。
6. 私有入口不会自动关闭公共入口
Gateway Interface Endpoint 的端点策略可以限制允许调用的 Gateway ARN,但公共 Gateway URL 仍可能存在。还需要为 Gateway 附加资源策略:仅当 aws:SourceVpce 等于指定 Interface Endpoint 时允许 bedrock-agentcore:InvokeGateway,其余来源拒绝。
实验关闭公共入口后,外部调用返回 JSON-RPC -32002,私有端点调用保持成功。测试中策略约 30 秒后生效,但 AWS 文档给出的传播窗口最长可达 15 分钟,因此自动化验收必须设置相应等待时间。
安全能力不等于内容审计
这套架构提供的是网络路径控制、身份校验和元数据检查,不是 TLS 载荷解密:
- Gateway 到 ALB 之间保持端到端 TLS,防火墙只能看到流量元数据与 TLS SNI,无法看到工具参数和响应正文。
- Agent 到 Gateway Interface Endpoint、Gateway 到 Resource Gateway,以及 AgentCore 获取 OAuth 令牌的请求,不经过中央防火墙。
- 使用 client credentials grant 时,工具侧看到的是 Gateway 客户端身份,而不是最终用户的身份。要追溯用户,需要读取 Gateway 应用日志中的入站 JWT claims。
- 可选 WAF 默认只检查请求体前 16 KB,可调到 64 KB;更大的工具调用必须设计分段、阻断或替代检查策略。
- 私有端点 Target 默认不能使用
NO_AUTH,除非额外配置 interceptor function。
如果合规目标要求检查提示词、工具参数或响应内容,必须部署受控的 TLS 终止代理或应用层审计链路;不能仅依赖该参考架构中的 Network Firewall。
官方测试证据与局限
AWS在包含一个管理账号和三个成员账号的实验室环境中验证了该模式,公开仓库还提供 14 项完整检查。主要结果包括:
| 验证目标 | 观察结果 | 适用范围 |
|---|---|---|
| 请求来源 | ALB 访问日志中的源地址落在 Resource Gateway 网段 | 未启用源 NAT 的环境 |
| 请求经过防火墙 | 防火墙流日志记录 Resource Gateway 到工具 VPC 的 443 TLS 流 | AWS Network Firewall appliance mode |
| 回包经过防火墙 | 人为加入回程丢弃规则后调用超时,并出现 to_client 丢弃日志 | 有状态防火墙 |
| 工具边界鉴权 | 无令牌、错误 IdP 令牌和错误客户端令牌均在后端执行前返回 401 | ALB JWT 校验 |
| 关闭公共入口 | 外部调用返回 -32002,私有端点继续工作 | 依赖资源策略传播 |
| 多账号后端 | 第二个账号的 API 可复用同一 Resource Configuration,无需修改网络 | 私有 API Gateway 变体 |
这些结果证明了路由和身份链路可行,但并非性能基准。文章没有公布端到端时延、吞吐、检查点容量或防火墙开销,也没有独立第三方复现。测试还只覆盖 us-east-1、AWS Network Firewall、无源 NAT;多区域、私有身份提供方及其他 OpenAPI 限制没有进入同一实验矩阵。
工程权衡
- 性能:TGW 与中央防火墙会引入额外跳数和潜在瓶颈。AWS未提供时延数据,不能据此声称相对原生路径“性能无损”;生产环境应按目标 VPC、每秒工具调用数和报文大小压测。
- 成本:VPC Lattice Service Network Resource Association 按小时收费并叠加数据处理费用,而且通常每个 Target 会产生一个关联。应合并同一 API 或 MCP Server 的操作,避免把大量细碎工具拆成许多 Target。
- 配额:Gateway 工具调用配额同时作用于账号和 Gateway。AWS建议每个环境使用独立 AgentCore 账号,并按业务域或智能体组提前拆分 Gateway,不要等到触顶后再迁移。
- 长连接:VPC Lattice 会关闭空闲连接,长生命周期 MCP 流需要 keepalive,否则会出现间歇性调用失败。
- 源 NAT:若防火墙做源 NAT,工具侧安全组必须允许防火墙地址,此时安全边界会转为“防火墙允许列表 + 工具侧令牌校验”的组合。
- 身份出口:智能体获取入站令牌、ALB 获取 JWKS、AgentCore 获取 OAuth 令牌都可能离开私有工具链路,必须单独规划路由、DNS和出口策略。
落地建议
- 先画信任边界:盘点账号、VPC、子网、Transit Gateway attachment、工具账号和身份提供方,确认中央网络团队是否真正拥有全部子网及路由。
- 在非生产环境复用模板:从官方仓库部署 CloudFormation,固定 AWS CLI 或 Boto3 版本,并按自己的地址规划、可用区和配额修改参数。
- 先建网络,再接身份:创建 Resource Gateway、TGW 路由、Resource Configuration 和 RAM 共享,随后配置 OAuth Credential Provider、ALB
jwt-validation与 API authorizer。 - 执行正反向验证:不仅确认请求成功,还要临时丢弃回程流量,证明请求和响应都经过防火墙;分别测试缺失、错误和越权令牌。
- 验证旁路已被阻断:尝试在 AgentCore 账号自行创建 Resource VPC Endpoint 和 Service Network Association,确认 SCP 拒绝,同时 Gateway Target 仍可正常进入
READY。 - 关闭公共入口并观察传播:在资源策略生效后等待最长 15 分钟,再从公网和 Interface Endpoint 两侧执行对照测试。
- 准备撤销顺序:需要回收权限时,先删除 Gateway Target 或 Service Network Resource Association,再从 RAM 共享中移除 Resource Configuration;仅删除共享不会自动移除既有关联。
- 加入持续审计:通过 EventBridge 监控
CreateServiceNetworkResourceAssociationBySharee,并跟踪 CloudTrail、ALB、WAF、Gateway 应用日志与防火墙流日志,形成端到端调用链。
适用边界
该模式适合同时满足以下条件的组织:网络账号拥有全部 VPC、子网和 TGW attachment;应用子网通过 RAM 共享;所有跨 VPC 流量必须经过中央检查 VPC;应用团队只负责自己的服务和安全组。
如果 Gateway 账号可以拥有可达工具的子网,应优先使用托管模式;如果 Gateway 与工具之间不要求集中检查,可直接采用标准 self-managed 模式;如果工具仅暴露在公共端点,则无需引入 Resource Gateway。该方案的价值不在于创造新的连接能力,而在于把现有 AgentCore Gateway、VPC Lattice、Transit Gateway、RAM、ALB 和防火墙组合成职责清晰、可审计的企业级私有工具接入路径。
—— 完 ——消息来源:AWS Machine Learning Blog (2026-11-18)
主题标签: #AWS #Amazon Bedrock AgentCore #VPC Lattice #私有API #网络安全
编辑部与事实核查说明:本篇专刊由智客前沿资讯管线根据官方技术公告、学术论文及开源工程文档整理编译,经算法实体核验与人工编辑审校后发布。若发现技术事实纰漏,欢迎依据勘误方针或一键向编辑部发送勘误反馈。
社区整体评论区