代理身分驗證管理員總覽

生成式 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。

下方的流程圖說明高階架構和憑證擷取生命週期: 傳出憑證擷取架構圖。

  1. 使用者觸發需要驗證外部工具的事件或提示。
  2. 部署的代理 (使用 ADK) 會透明地攔截工具要求,並查詢安全驗證管理工具保管庫。
  3. 驗證管理員會將安全憑證 (API 金鑰或 OAuth 權杖) 傳回給代理。
  4. 代理會使用附加的憑證叫用外部 API 或工具。
  5. 第三方服務會驗證憑證,並將要求的資料傳回給代理。
  6. 代理會使用傳回的資料生成最終回覆,並提供給使用者。

第三方整合服務範例

驗證管理工具支援標準 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 位置」。

後續步驟