生成式 AI 代理與外部工具、API 或服務 (例如 BigQuery、Jira、GitHub 或 Google 地圖) 互動時,需要安全機制來驗證傳出要求。Agent Identity 驗證管理工具 (驗證管理工具) 扮演集中式憑證儲存庫和驗證代理程式的角色,可簡化呼叫外部工具時的驗證工作。
使用驗證管理工具的好處
Auth Manager 可為代理開發帶來下列好處:
- 集中式憑證保管箱:將 API 金鑰、OAuth 用戶端密鑰和使用者權杖儲存在 Google 代管的保管箱中,避免硬式編碼密鑰和自訂資料庫儲存空間。
- 自動化 OAuth 2.0:處理多步驟 OAuth 2.0 流程,例如使用者同意聲明、授權碼交換和權杖更新,不需自訂後端程式碼。
- 與 ADK 完美整合:與 Agent Development Kit (ADK) 原生整合,可擷取傳出驗證標頭 (例如
Authorization或X-Goog-Api-Key),並插入工具和 Model Context Protocol (MCP) 伺服器叫用。 - 精細的 SPIFFE ID 存取控管:使用以 SPIFFE 為基礎的代理身分,定義精確的身分與存取權管理 (IAM) 政策,確保只有授權的代理主體和開發人員,才能存取特定驗證供應商。
驗證管理工具的運作方式
驗證管理工具可做為 Gemini Enterprise Agent Platform 的 Agent Runtime 環境與外部服務端點之間的憑證保管箱。
代理呼叫外部工具時,ADK 會攔截工具執行作業、向驗證管理工具保管箱要求適當的憑證,並附加必要的驗證標頭,再將要求分派至目標 API。
下方的流程圖說明高階架構和憑證擷取生命週期:
- 使用者觸發需要驗證外部工具的事件或提示。
- 部署的代理 (使用 ADK) 會透明地攔截工具要求,並查詢安全驗證管理工具保管庫。
- 驗證管理員會將安全憑證 (API 金鑰或 OAuth 權杖) 傳回給代理。
- 代理會使用附加的憑證叫用外部 API 或工具。
- 第三方服務會驗證憑證,並將要求的資料傳回給代理。
- 代理會使用傳回的資料生成最終回覆,並提供給使用者。
第三方整合服務範例
驗證管理工具支援標準 OAuth 2.0 和 API 金鑰模式,因此與許多第三方服務相容。
下表列出一些經過驗證的第三方服務、支援的驗證方式,以及設定說明文件。
| 服務 | 支援的驗證方式 | 憑證設定說明文件 |
|---|---|---|
| Atlassian Jira | 3-legged 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 位置」。