客户端代表需要接入智能体身份和权限管理平台进行用户认证的应用程序。无论是 Web 应用、单页应用（SPA）、移动应用还是后台服务（M2M），你都需要为其创建一个客户端，以获得用于发起认证流程的 **Client ID** 和 **Client Secret**。 ## 核心价值 * **统一身份接入**：集中管理应用的认证配置，避免重复开发登录逻辑。 * **安全边界控制**：通过回调URL白名单、Token有效期等限制，防止恶意请求伪造身份。 * **多场景适配**：支持 Web 应用、单页应用（SPA）、移动应用、机器服务（M2M）等多种类型，覆盖不同认证需求。 ## 前提条件你已创建用户池，相关操作可参考[创建用户池](https://www.volcengine.com/docs/86848/1928256)。 ## 操作步骤 1. 登录[火山引擎智能体身份和权限管理平台](https://console.volcengine.com/identity)。 2. 在左侧导航栏，选择**身份管理 \> 用户池**。 3. 单击目标用户池名称，进入指定的用户池详情页面。 4. 切换到**客户端**标签页，单击**新建客户端**。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/be47feba43124374b3bf27b8992e586d) 5. 配置客户端相关参数。 |配置项 |说明 |示例 | |---|---|---| |**客户端名称** |必填。为你的应用客户端设置一个描述性名称，如 `my-company-portal`。 |企业门户Web应用 | |**客户端类型** |必填。根据你的应用类型选择：

* **Web 应用**：传统的服务端网站应用（如 Java、PHP）。

* **单页应用程序 (SPA)** ：前后端分离的应用（如 React、Vue）。

* **移动应用**：安装在手机或平板设备的原生应用（如 iOS、Android App）。

* **M2M (Machine\-to\-Machine)** ：没有用户交互的后台服务间调用（如定时任务、微服务）。 |Web应用 | |**授权回调 URL** |* 必填（M2M 类型除外）。

* 用户成功登录并授权后，Agent Identity 会将用户重定向到此 URL，并附上授权码或令牌，客户端需在此地址接收并处理授权结果。

* 支持批量输入，每行一个，必须以 `http://` 或 `https://` 开头。

注意

未配置或配置错误会导致授权失败，需确保与应用实际域名一致。

|`https://app.example.com/callback` | 6. 单击**确定**。系统将为你生成 **Client ID** 和 **Client Secret**。你需要在应用中配置这两个参数作为客户端的身份标识和密钥。 * **Client ID：** 客户端身份**的**唯一标识符，用于在身份验证请求中标识客户端应用。 * **Client Secret**：客户端身份的密钥，用于在身份验证请求中验证客户端身份。 ## 其他操作 ### 查看和编辑客户端 * **查看**：在客户端列表中，点击任意客户端的名称，即可进入其详情页面。详情页会展示客户端的详情，如 Client ID、Client Secret、回调 URL 等。 * **编辑**：在客户端列表的操作列，点击**编辑**，即可修改当前客户端的相关信息。 |配置项 |说明 |示例 | |---|---|---| |**登出重定向 URL** |选填。用户登出后，可以被重定向到的 URL 列表。 |`https://app.example.com/logout` | |**跨域请求源** |* 选填。允许发起 OAuth 登录请求的前端域名，限制跨域请求来源。

* 支持通配符`*`。 |`https://*.example.com` | |**CORS 允许域名** |选填。允许通过 AJAX 获取令牌的域名，解决前端跨域请求限制。 |`https://api.example.com` | |**ID Token 有效期** |选填。设置 ID Token 的有效时间（单位：秒），默认为 36000 秒（10 小时）。 |36000 |

说明

客户端类型以及创建后自动生成的 Client ID 和 Client Secret 在创建后不可更改。

### **删除客户端** 在客户端列表的操作列中点击**删除**。这将永久移除客户端及其配置。

AgentKit