跳到内容

A2A 的企业实施

Agent2Agent (A2A) 协议的设计核心是企业需求。A2A 旨在与现有企业基础设施和广泛采用的最佳实践无缝集成，而不是发明新的专有安全和操作标准。这种方法使组织能够利用其在安全、监控、治理和身份管理方面的现有投资和专业知识。

A2A 的一个关键原则是代理通常是不透明的，因为它们不共享内部内存、工具或直接资源访问。这种不透明性自然符合标准的客户端-服务器安全范式，将远程代理视为标准的基于 HTTP 的企业应用程序。

传输层安全 (TLS)

确保传输中数据的机密性和完整性是任何企业应用程序的基础。

  • HTTPS 强制要求：生产环境中的所有 A2A 通信都必须通过 HTTPS 进行。
  • 现代 TLS 标准：实现应使用现代 TLS 版本。建议使用 TLS 1.2 或更高版本。应使用强大、行业标准的密码套件来保护数据免受窃听和篡改。
  • 服务器身份验证：A2A 客户端应在 TLS 握手期间通过根据受信任的证书颁发机构验证 A2A 服务器的 TLS 证书来验证其身份。这可以防止中间人攻击。

认证

A2A 将认证委托给标准 Web 机制。它主要依赖 HTTP 标头和 OAuth2 和 OpenID Connect 等既定标准。认证要求由 A2A 服务器在其 Agent Card 中公布。

  • 有效载荷中无身份：A2A 协议有效载荷（例如 JSON-RPC 消息）不直接携带用户或客户端身份信息。身份在传输/HTTP 层建立。
  • Agent Card 声明：A2A 服务器的 Agent Card 在其 security 字段中描述了它支持的认证方案，并与 OpenAPI Specification 中定义的认证方案一致。
  • 带外凭证获取：A2A 客户端通过 A2A 协议本身之外的流程获取必要的凭证，例如 OAuth 2.0 令牌或 API 密钥。示例包括 OAuth 流或安全密钥分发。
  • HTTP 标头传输：凭证必须根据所选认证方案的要求在标准 HTTP 标头中传输。示例包括 Authorization: Bearer 或 API-Key: 。
  • 服务器端验证：A2A 服务器必须使用 HTTP 标头中提供的凭证对每个传入请求进行认证。
    • 如果认证失败或凭证缺失，服务器应响应标准 HTTP 状态码
      • 401 Unauthorized：如果凭证缺失或无效。此响应应包含 WWW-Authenticate 标头，以告知客户端支持的认证方法。
      • 403 Forbidden：如果凭证有效，但经过认证的客户端无权执行所请求的操作。
  • 任务内认证（二级凭证）：如果代理在任务期间需要额外凭证才能访问不同的系统或服务（例如，代表用户使用特定工具），A2A 服务器会向客户端指示需要更多信息。然后，客户端负责通过 A2A 协议本身之外的流程（例如 OAuth 流）获取这些二级凭证，并将其提供回 A2A 服务器以继续任务。

授权

客户端经过认证后，A2A 服务器负责授权请求。授权逻辑特定于代理的实现、它处理的数据以及适用的企业策略。

  • 细粒度控制：授权应根据经过认证的身份应用，该身份可以代表最终用户、客户端应用程序或两者。
  • 基于技能的授权：访问可以按技能进行控制，如 Agent Card 中公布的。例如，特定的 OAuth 范围应授予经过认证的客户端调用某些技能的权限，但不能调用其他技能。
  • 数据和操作级别授权：与后端系统、数据库或工具交互的代理必须在通过这些底层资源执行敏感操作或访问敏感数据之前强制执行适当的授权。代理充当看门人。
  • 最小特权原则：代理必须仅授予客户端或用户通过 A2A 接口执行其预期操作所需的必要权限。

数据隐私和机密性

保护代理之间交换的敏感数据至关重要，需要严格遵守隐私法规和最佳实践。

  • 敏感度意识：实施者必须敏锐地意识到 A2A 交互中消息和工件部分中交换数据的敏感度。
  • 合规性：根据所涉及的领域和数据，确保遵守 GDPR、CCPA 和 HIPAA 等相关数据隐私法规。
  • 数据最小化：避免在 A2A 交换中包含或请求不必要的敏感信息。
  • 安全处理：根据企业数据安全策略和法规要求，保护传输中的数据（强制使用 TLS）和代理持久化后的静止数据。

跟踪、可观察性和监控

A2A 对 HTTP 的依赖允许与标准企业跟踪、日志记录和监控工具直接集成，为代理间工作流提供关键可见性。

  • 分布式跟踪：A2A 客户端和服务器应参与分布式跟踪系统。例如，使用 OpenTelemetry 通过标准 HTTP 标头（如 W3C Trace Context 标头）传播跟踪上下文，包括跟踪 ID 和跨度 ID。这实现了端到端可见性，用于调试和性能分析。
  • 全面日志记录：在客户端和服务器上记录详细信息，包括 taskId、sessionId、关联 ID 和跟踪上下文，用于故障排除和审计。
  • 指标：A2A 服务器应公开关键操作指标，例如请求速率、错误速率、任务处理延迟和资源利用率，以实现性能监控、警报和容量规划。
  • 审计：审计重要事件，例如任务创建、关键状态更改和代理操作，特别是在涉及敏感数据或高影响操作时。

API 管理与治理

对于对外暴露、跨组织边界甚至在大型企业内部的 A2A 服务器，强烈建议与 API 管理解决方案集成，因为它提供

  • 集中式策略实施：一致应用安全策略，例如认证和授权、速率限制和配额。
  • 流量管理：负载均衡、路由和中介。
  • 分析和报告：洞察代理使用情况、性能和趋势。
  • 开发者门户：促进 A2A 启用代理的发现，提供 Agent Card 等文档，并简化客户端开发人员的入职流程。

通过遵循这些企业级实践，A2A 实施可以在复杂的组织环境中安全、可靠、可管理地部署。这培养了信任并实现了可扩展的代理间协作。