AgentTeams零凭据暴露安全设计深度解析Higress AI网关如何安全管理LLM与MCP流量【免费下载链接】AgentTeamsAn open-source Collaborative Multi-Agent OS for transparent, human-in-the-loop task coordination via Matrix rooms.项目地址: https://gitcode.com/gh_mirrors/hi/AgentTeamsAgentTeams 是一个开源的协作式多 Agent 操作系统让多个 AI Agent 通过 Matrix 房间透明协作、支持人类随时介入。在多 Agent 场景下最棘手的安全问题之一是如何让每个 Worker 都能调用 LLM 和 MCP 工具却不把大模型 API Key 暴露给任何 Agent 容器——这就是 AgentTeams 的零凭据暴露设计目标。本文带你完整看懂 AgentTeams 如何用 Higress AI 网关统一接管 LLM 与 MCP 流量实现按 Agent 独立签发密钥、按路由授权、随删随回收的安全闭环。一、为什么多 Agent 系统需要零凭据暴露想象一个典型场景你创建了 5 个 Worker Agent 帮你写代码、查资料、做分析。如果直接把大模型 API Key 写进每个容器的环境变量就会出现三个安全隐患密钥扩散5 个容器 日志 备份里都散落着同一把万能钥匙权限失控任何 Worker 被盗用后可以无限制消耗你的模型配额无法回收删除某个 Worker 后它手里的密钥依然有效AgentTeams 的解法很直接Worker 容器里从来不存放 LLM 提供商的真实密钥所有模型调用都必须经过 Higress AI 网关Worker 只持有网关为它单独签发的一把消费级密钥。二、Higress AI 网关LLM 与 MCP 流量的唯一入口在 AgentTeams 的架构中Higress 扮演的是AI 流量收费站 安检门的角色真实密钥只存在网关里你在安装时配置的 LLM API Key 由 Controller 通过EnsureAIProvider注册为网关侧的 AI Provider见 aigateway.go密钥只保留在 Higress 数据平面Agent 容器永远看不到Worker 拿到的是代金券而非钥匙每个 Worker/Manager 都会获得一个网关消费者Consumer持有专属的GatewayKey流量统一收口Worker 看到的模型地址是网关数据平面地址而不是模型厂商端点在 Worker 容器的环境变量构建逻辑中可以清楚看到注入的是网关密钥和网关地址而非 LLM 密钥AGENTTEAMS_WORKER_GATEWAY_KEY本网关消费者的密钥AGENTTEAMS_AI_GATEWAY_URLAI 网关数据平面地址对应源码见 worker_env.go 中的Build与BuildManager函数以及集群默认值注入的applyClusterDefaults。三、密钥如何自动签发控制器全自动闭环整个过程由 Controller 的 Provisioner 自动完成无需人工操作核心逻辑见 provisioner.go步骤动作网关接口1为 Worker 创建 Consumer签发独立 API KeyEnsureConsumer2把 Consumer 加入 AI 路由白名单AuthorizeAIRoutes3把 GatewayKey 注入该 Worker 容器环境变量容器编排层4Worker 删除时立即吊销密钥、移出白名单DeleteConsumerDeauthorizeAIRoutes几个值得细看的工程设计细节3.1 幂等签发重启不出错EnsureConsumer是幂等的重复调用同一名字直接返回已存在的 Consumer。当并发 Reconcile 抢跑时客户端会捕获 409 冲突并重新查询避免密钥重复签发见 higress.go 中的EnsureConsumer。3.2 白名单写入权分离杜绝 403 锁死AI 路由骨架路径、上游 Provider、key-auth 开关只由 Initializer 创建allowedConsumers白名单字段则只有Manager/Worker Reconciler 可以写。这种职责分离彻底消除了控制器重启时白名单被意外重置、导致全体 Agent 瞬时被 403 锁死的问题——设计意图在 types.go 的AIRouteRequest注释中写得非常清楚。3.3 按模型 Provider 精细授权当指定了modelAPIID时AuthorizeAIRoutes会把 Consumer 只保留在匹配的 Provider 路由上、从其他路由移除routeMatchesProvider匹配逻辑实现这个 Worker 只能用这个模型的最小权限控制。四、MCP 流量同一条安全链路很多多 Agent 系统只防护了 LLM 调用却忽视了 MCPModel Context Protocol工具流量。AgentTeams 的处理方式同样干净利落Worker 的 MCP 服务器清单由 mcporter.go 的GenerateMcporterConfig生成MCP 端点地址通过网关透传MCP 请求携带的是 Worker 自己的 GatewayKey网关按消费者识别来源做到与 LLM 调用同等粒度的审计和限流能力网关侧还针对流式响应设置了独立的空闲超时EnsureStreamIdleTimeout默认 900 秒保证长任务 SSE 流不被误断一句话LLM 与 MCP 共用一条安检通道不存在旁路。五、云网关模式同一套接口另一套实现如果部署在阿里云环境AgentTeams 会自动切换到AIGatewayClient对接 APIG 云网关Consumer 以GatewayID-名字前缀创建避免多租户账号下的命名冲突授权规则通过CreateConsumerAuthorizationRules绑定到指定 LLM Model API支持长期有效模式云网关上路由/Provider 属于平台侧资源控制面不会越权操作相关方法直接返回ErrUnsupportedOp快速失败防止静默降级实现见 aigateway.go接口抽象定义在 client.go两种后端对上层完全透明。六、安全收益清单✅LLM 真实密钥零扩散——只存在于网关数据平面 ✅每 Agent 独立密钥——可独立吊销、独立审计 ✅最小权限路由——按模型 Provider 精细白名单 ✅删除即失效——DeleteConsumer 白名单移除一步到位 ✅MCP 流量同等防护——无旁路、统一入口 ✅云/自建双模式——Higress 与 APIG 一套接口平滑切换延伸阅读网关接口抽象client.goHigress 客户端实现higress.go云网关APIG客户端aigateway.go消费者类型定义types.goWorker 环境变量构建worker_env.goMCP 配置生成mcporter.go本地部署指南docs/usage/deployment/local.md运行时配置契约docs/design/member-runtime-config-contract.md【免费下载链接】AgentTeamsAn open-source Collaborative Multi-Agent OS for transparent, human-in-the-loop task coordination via Matrix rooms.项目地址: https://gitcode.com/gh_mirrors/hi/AgentTeams创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
AgentTeams零凭据暴露安全设计深度解析：Higress AI网关如何安全管理LLM与MCP流量
AgentTeams零凭据暴露安全设计深度解析Higress AI网关如何安全管理LLM与MCP流量【免费下载链接】AgentTeamsAn open-source Collaborative Multi-Agent OS for transparent, human-in-the-loop task coordination via Matrix rooms.项目地址: https://gitcode.com/gh_mirrors/hi/AgentTeamsAgentTeams 是一个开源的协作式多 Agent 操作系统让多个 AI Agent 通过 Matrix 房间透明协作、支持人类随时介入。在多 Agent 场景下最棘手的安全问题之一是如何让每个 Worker 都能调用 LLM 和 MCP 工具却不把大模型 API Key 暴露给任何 Agent 容器——这就是 AgentTeams 的零凭据暴露设计目标。本文带你完整看懂 AgentTeams 如何用 Higress AI 网关统一接管 LLM 与 MCP 流量实现按 Agent 独立签发密钥、按路由授权、随删随回收的安全闭环。一、为什么多 Agent 系统需要零凭据暴露想象一个典型场景你创建了 5 个 Worker Agent 帮你写代码、查资料、做分析。如果直接把大模型 API Key 写进每个容器的环境变量就会出现三个安全隐患密钥扩散5 个容器 日志 备份里都散落着同一把万能钥匙权限失控任何 Worker 被盗用后可以无限制消耗你的模型配额无法回收删除某个 Worker 后它手里的密钥依然有效AgentTeams 的解法很直接Worker 容器里从来不存放 LLM 提供商的真实密钥所有模型调用都必须经过 Higress AI 网关Worker 只持有网关为它单独签发的一把消费级密钥。二、Higress AI 网关LLM 与 MCP 流量的唯一入口在 AgentTeams 的架构中Higress 扮演的是AI 流量收费站 安检门的角色真实密钥只存在网关里你在安装时配置的 LLM API Key 由 Controller 通过EnsureAIProvider注册为网关侧的 AI Provider见 aigateway.go密钥只保留在 Higress 数据平面Agent 容器永远看不到Worker 拿到的是代金券而非钥匙每个 Worker/Manager 都会获得一个网关消费者Consumer持有专属的GatewayKey流量统一收口Worker 看到的模型地址是网关数据平面地址而不是模型厂商端点在 Worker 容器的环境变量构建逻辑中可以清楚看到注入的是网关密钥和网关地址而非 LLM 密钥AGENTTEAMS_WORKER_GATEWAY_KEY本网关消费者的密钥AGENTTEAMS_AI_GATEWAY_URLAI 网关数据平面地址对应源码见 worker_env.go 中的Build与BuildManager函数以及集群默认值注入的applyClusterDefaults。三、密钥如何自动签发控制器全自动闭环整个过程由 Controller 的 Provisioner 自动完成无需人工操作核心逻辑见 provisioner.go步骤动作网关接口1为 Worker 创建 Consumer签发独立 API KeyEnsureConsumer2把 Consumer 加入 AI 路由白名单AuthorizeAIRoutes3把 GatewayKey 注入该 Worker 容器环境变量容器编排层4Worker 删除时立即吊销密钥、移出白名单DeleteConsumerDeauthorizeAIRoutes几个值得细看的工程设计细节3.1 幂等签发重启不出错EnsureConsumer是幂等的重复调用同一名字直接返回已存在的 Consumer。当并发 Reconcile 抢跑时客户端会捕获 409 冲突并重新查询避免密钥重复签发见 higress.go 中的EnsureConsumer。3.2 白名单写入权分离杜绝 403 锁死AI 路由骨架路径、上游 Provider、key-auth 开关只由 Initializer 创建allowedConsumers白名单字段则只有Manager/Worker Reconciler 可以写。这种职责分离彻底消除了控制器重启时白名单被意外重置、导致全体 Agent 瞬时被 403 锁死的问题——设计意图在 types.go 的AIRouteRequest注释中写得非常清楚。3.3 按模型 Provider 精细授权当指定了modelAPIID时AuthorizeAIRoutes会把 Consumer 只保留在匹配的 Provider 路由上、从其他路由移除routeMatchesProvider匹配逻辑实现这个 Worker 只能用这个模型的最小权限控制。四、MCP 流量同一条安全链路很多多 Agent 系统只防护了 LLM 调用却忽视了 MCPModel Context Protocol工具流量。AgentTeams 的处理方式同样干净利落Worker 的 MCP 服务器清单由 mcporter.go 的GenerateMcporterConfig生成MCP 端点地址通过网关透传MCP 请求携带的是 Worker 自己的 GatewayKey网关按消费者识别来源做到与 LLM 调用同等粒度的审计和限流能力网关侧还针对流式响应设置了独立的空闲超时EnsureStreamIdleTimeout默认 900 秒保证长任务 SSE 流不被误断一句话LLM 与 MCP 共用一条安检通道不存在旁路。五、云网关模式同一套接口另一套实现如果部署在阿里云环境AgentTeams 会自动切换到AIGatewayClient对接 APIG 云网关Consumer 以GatewayID-名字前缀创建避免多租户账号下的命名冲突授权规则通过CreateConsumerAuthorizationRules绑定到指定 LLM Model API支持长期有效模式云网关上路由/Provider 属于平台侧资源控制面不会越权操作相关方法直接返回ErrUnsupportedOp快速失败防止静默降级实现见 aigateway.go接口抽象定义在 client.go两种后端对上层完全透明。六、安全收益清单✅LLM 真实密钥零扩散——只存在于网关数据平面 ✅每 Agent 独立密钥——可独立吊销、独立审计 ✅最小权限路由——按模型 Provider 精细白名单 ✅删除即失效——DeleteConsumer 白名单移除一步到位 ✅MCP 流量同等防护——无旁路、统一入口 ✅云/自建双模式——Higress 与 APIG 一套接口平滑切换延伸阅读网关接口抽象client.goHigress 客户端实现higress.go云网关APIG客户端aigateway.go消费者类型定义types.goWorker 环境变量构建worker_env.goMCP 配置生成mcporter.go本地部署指南docs/usage/deployment/local.md运行时配置契约docs/design/member-runtime-config-contract.md【免费下载链接】AgentTeamsAn open-source Collaborative Multi-Agent OS for transparent, human-in-the-loop task coordination via Matrix rooms.项目地址: https://gitcode.com/gh_mirrors/hi/AgentTeams创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
