Gemini Enterprise:自定义 UI 从平台继承的认证机制
一位 Google Cloud 前向部署工程师解释了当企业绕过 Gemini Enterprise 内置 Web UI 并直接调用 StreamAssist API 时,需由客户负责的三个独立认证层,包括为何在代理注册层面的根级 OAuth 会阻碍多工具场景,以及如何使用 GCP Auth Manager Token Vault 实现按工具按需认证来解决这一问题。
当企业在 Gemini Enterprise 之上构建自定义界面而非使用其内置 Web 应用时,他们将继承平台此前自动处理的三种认证流程。Google Cloud 的前向部署工程师 Neeraj Agrawal 在一份 2026 年 11 月的指南中逐一介绍了每一层:对用户进行 StreamAssist API 的身份验证(通过 Google Identity、Workforce Identity Federation 或 Workload Identity Federation),通过存储在 Gemini Enterprise 托管 Keystore 中的令牌执行三方 OAuth (3-Legged OAuth) 以授权 Federated Connectors,以及处理部署在 Vertex AI Agent Engine 上的自定义 ADK 代理的按工具 OAuth。
最具可迁移性的见解涉及第三层。Agrawal 解释说,在根代理注册层面附加静态 OAuth 配置会预先阻塞整个代理——用户无法在不被迫经过每个连接器登录的情况下询问一般性政策问题。解决方案是使用由 GCP Auth Manager 的 Token Vault 支持的 GcpAuthProvider 包装受保护的子代理工具,启用代理身份 (Agent Identity) 进行部署,并仅在实际调用受保护工具时触发三方 OAuth (3LO) 弹窗。首次授权后,后续查询将在单轮对话中运行,无需弹窗。
这是针对 Google 自身产品的厂商编写指南。具体组件(GcpAuthProvider、AuthenticatedFunctionTool、SPIFFE 身份、Keystore)与 Google Cloud 基础设施紧密耦合,且未提供对该模式有效性或采用情况的独立验证,超出此生态系统范围。