文档中心

智能体身份和权限管理平台

快速入门

入站授权：集成企业 SSO 实现联合登录

本指南介绍如何配置智能体身份和权限管理平台以集成现有的企业身份体系（如 Okta, Azure AD, Google Workspace）。配置完成后，企业员工无需重新注册，即可直接使用现有企业账号登录你的应用。

前提条件

你已开通智能体身份和权限管理平台服务并完成授权。详情请参见开通智能体身份和权限管理平台并完成授权。

你已获取外部身份提供商的信息，包括Issuer/Discovery URL, Client ID, Client Secret。

步骤一创建用户池

用户池是存放用户账号的容器。你的所有用户数据（用户名、密码、手机号等）都将存储在这里。

登录火山引擎智能体身份和权限管理平台。

在左侧导航栏，选择用户池。

单击右上角的新建用户池。

配置用户池参数。

用户池名称：输入易于识别的名称，例如 my-web-app-pool。

其他参数可保持默认。

单击确定。

步骤二创建客户端

为了让你的应用能够“连接”到刚才创建的用户池，你需要注册一个客户端。

在返回的页面单击新建客户端。

配置客户端基础信息。

客户端名称：my-webapp-client。

客户端类型：选择 Web 应用。

授权回调 URL：关键配置。这是用户登录成功后，Agent Identity 将用户送回你应用的地址。

本地调试示例：http://localhost:8000/callback

生产环境示例：https://agent.com/auth/callback

注意

此处配置的 URL 必须与你代码中配置的 Redirect URI 完全一致（包括末尾的斜杠），否则会产生 redirect_uri_mismatch 错误。

单击确定。

步骤三添加外部身份提供商

在用户池列表，单击用户池名称。

切换到外部身份提供商标签页，单击新建提供商。

配置相关信息。

提供商名称：自定义你的提供商名称，该名称将展示在用户登录页，供用户登录时选择。例如my-corporate-idp。

提供商类型：选择 OIDC。

发行者 URL：填入外部身份提供商的发行者 URL。

Client ID / Client Secret：填入你从外部身份提供商获得的客户端标识信息和密钥，用于标识该用户池与外部身份提供商之间的信任关系并进行授权。

授权作用域：请求访问的信息范围，至少填入 openid。

用户身份联动配置：保持默认。

单击确定。

步骤四回填回调地址

在用户池列表，找到创建好的用户池。

单击用户池名称，查看用户池详情。

找到系统生成的 OIDC 登录回调地址。

复制这个地址。

回到你的外部身份提供商后台，将此地址填入其 OAuth 应用配置的 Redirect URI 字段中。

说明

外部身份提供商认证通过后，需要通过此地址将用户凭证安全地送回 Agent Identity。

验证配置效果

打开 Agent 登录页面。

页面上除了账号密码输入框外，会出现一个新的按钮。

该按钮名称是你在步骤三中配置的外部身份提供商的名称。

单击该按钮：

浏览器应跳转至你的企业登录页。

输入企业账号完成登录。

浏览器自动跳回智能体身份和权限管理平台，再跳回你的 Agent。

你的 Agent 成功获取到当前员工的 Token 信息。

最近更新时间：2026.03.25 11:22:27

这个页面对您有帮助吗？

有用

无用