当生成式 AI 智能体与外部工具、API 或服务(例如 BigQuery、Jira、GitHub 或 Google 地图)交互时,它们需要一种安全机制来对出站请求进行身份验证。Agent Identity 身份验证管理器(身份验证管理器)通过充当集中式凭证保险柜和身份验证代理来提供此功能,从而简化出站工具身份验证。
使用身份验证管理器的优势
身份验证管理器为智能体开发提供了以下优势:
- 集中式凭证保险柜:将 API 密钥、OAuth 客户端密钥和用户令牌存储在 Google 管理的保险柜中,有助于避免硬编码密钥和自定义数据库存储。
- 自动化 OAuth 2.0:无需自定义后端代码,即可处理多步骤 OAuth 2.0 流程,例如用户同意、授权代码交换和令牌刷新。
- 无缝 ADK 集成:与智能体开发套件 (ADK) 原生集成,可检索出站身份验证标头(例如
Authorization或X-Goog-Api-Key),并将其注入到工具和 Model Context Protocol (MCP) 服务器调用中。 - 精细的 SPIFFE ID 访问权限控制:使用基于 SPIFFE 的智能体身份来定义精确的 Identity and Access Management (IAM) 政策,有助于确保只有获得授权的智能体主体和开发者才能访问特定的身份验证提供方。
身份验证管理器的运作方式
身份验证管理器充当 Gemini Enterprise Agent Platform 上的 Agent Runtime 环境与外部服务端点之间的凭据保险柜。
当智能体调用外部工具时,ADK 会拦截工具执行,从身份验证管理器保险柜请求适当的凭证,并在将请求分派到目标 API 之前附加所需的身份验证标头。
以下流程图展示了大致架构和凭证检索生命周期:
- 最终用户触发需要出站工具身份验证的事件或提示。
- 已部署的智能体(使用 ADK)会以透明方式拦截工具请求,并查询安全身份验证管理器保险柜。
- 身份验证管理器会将安全凭证(API 密钥或 OAuth 令牌)返回给智能体。
- 智能体使用附加的凭据调用外部 API 或工具。
- 第三方服务会验证凭据,并将请求的数据返回给智能体。
- 代理使用返回的数据生成最终回答并将其提供给用户。
第三方集成示例
授权管理器支持标准 OAuth 2.0 和 API 密钥模式,因此可与许多第三方服务兼容。
下表列出了一些经过验证的第三方服务、其支持的身份验证方法以及设置文档。
| 服务 | 支持的身份验证方法 | 凭证设置文档 |
|---|---|---|
| Atlassian Jira | 三方 OAuth、API 密钥 | Jira OAuth 2.0 指南 |
| Dropbox | 三方模式 OAuth | Dropbox OAuth 指南 |
| GitHub | 三方模式 OAuth | GitHub OAuth 应用 |
| GitLab | 三方模式 OAuth | GitLab OAuth 提供方 |
| Microsoft | 三方模式 OAuth* | Microsoft 身份平台 |
| Salesforce | 三方模式 OAuth、两方模式 OAuth | Salesforce 关联的应用 |
| ServiceNow | 三方模式 OAuth*、两方模式 OAuth | ServiceNow OAuth 设置 |
* 如需详细了解服务限制和要求,请参阅服务专属注意事项。
服务专属注意事项
- Microsoft:身份验证管理器支持 Microsoft 的单范围集成。身份验证管理器不支持请求多个范围。 如需了解详情,请参阅 Microsoft 多个范围错误。
- ServiceNow:在 ServiceNow 中,管理员在应用级别配置允许的范围。无论代理请求什么,ServiceNow 都只会授予这些已配置的范围。如果代理需要未配置的范围,则身份验证可能会失败或进入请求循环。确保 ServiceNow 应用配置包含代理所需的所有范围。如需了解详情,请参阅 ServiceNow 身份验证循环或意外范围。
位置
Agent Identity 身份验证管理器在美洲、欧洲和亚太地区的各个区域均可使用。如需查看受支持的区域列表,请参阅Agent Identity 位置。