文档中心

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

快速入门

入站授权：为你的 Agent 开启快速登录功能

本文档将指导你如何通过智能体身份和权限管理平台快速为你的 Agent 集成标准的安全登录功能。

场景说明

假设你开发了一个 Agent，你希望用户不必单独注册账号，而是使用智能体身份和权限管理平台托管的账号体系进行登录。配置完成后，你的 Agent 将获得“验证用户身份（Authentication）”的能力。

前提条件

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

你拥有一个正在开发的 Agent 服务。

流程说明

步骤一创建用户池

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

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

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

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

配置用户池参数。

用户池名称：输入易于识别的名称，例如 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 错误。

单击确定。

步骤三创建用户

在集成代码之前，创建一个测试账号以验证流程。

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

配置用户信息。

用户名：testuser。

手机号：+86173********。

临时密码：设置一个符合以下要求的密码。

说明

密码必须包含数字、特殊字符、大小写字母。

长度至少为 8 位。

附加属性：设置一个附加属性（例如姓、名）。

点击确定。

步骤四在应用中集成配置

回到你的 Agent 代码中。Agent Identity 兼容标准的 OIDC 协议，你可以使用任何语言的 OIDC 客户端库（如 Python 的 authlib，Node.js 的 openid-client）进行集成。

获取参数配置

在 Agent Identity 用户池详情页或客户端详情页获取以下信息，并将它们映射到你的 OIDC 配置文件中：

控制台字段	代码配置参数	说明
OIDC 发现端点	ISSUER_URL / AUTHORITY	身份服务的根地址 (Base URL)
客户端 ID	CLIENT_ID	应用的公开唯一标识
客户端密钥	CLIENT_SECRET	安全敏感。请仅在后端使用，勿暴露在前端
授权回调 URL	REDIRECT_URI	必须与步骤二中填写的地址一致。

示例代码

验证配置效果

启动你的 Agent 服务。

单击登录，应用应将浏览器重定向到智能体身份和权限管理平台的统一登录页。

输入步骤三中创建的 testuser 账号和密码。

登录成功后，页面将自动跳转回你的 Redirect URI，并携带授权码。

你的后端服务将自动交换 Code 获取 Token，并完成用户登录。

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

这个页面对您有帮助吗？

有用

无用