AgentKit
AgentKit
文档指南
请输入
- 文档首页
AgentKitAgentKit用户指南身份与权限用户指南身份管理创建客户端
复制全文
下载 pdf创建客户端
文档反馈
问问助手客户端代表了需要接入 AgentKit 身份与权限管理模块进行用户认证的应用程序。无论是 Web 应用、单页应用（SPA）、移动应用还是后台服务（M2M），您都需要为其创建一个客户端，以获得用于发起认证流程的 Client ID 和 Client Secret。
核心价值
- 统一身份接入：集中管理应用的认证配置，避免重复开发登录逻辑。
- 安全边界控制：通过回调 URL 白名单、Token 有效期等限制，防止恶意请求伪造身份。
- 多场景适配：支持 Web 应用、单页应用（SPA）、移动应用、机器服务（M2M）等多种类型，覆盖不同认证需求。
前提条件
操作步骤
- 登录 AgentKit 控制台。
- 在左侧导航栏，选择“身份与权限 > 用户池管理”，单击目标用户池名称。
- 在用户池详情页面，切换到“客户端”页签，单击“新建客户端”按钮。
- 配置客户端相关参数。
- 配置项说明客户端名称自定义设置客户端名称。客户端类型根据您的应用类型选择客户端类型：
- Web 应用：传统的服务端网站应用（如 Java、PHP）。
- 单页应用程序 (SPA)：前后端分离的应用（如 React、Vue）。
- 移动应用：安装在手机或平板设备的原生应用（如 iOS、Android App）。
- M2M：即 Machine-to-Machine，没有用户交互的后台服务间调用（如定时任务、微服务）。
授权回调 URL请输入客户端可接受的回调地址白名单。- 用户成功登录并授权后，AgentKit 会将用户重定向到此 URL，并附上授权码或令牌，客户端需在此地址接收并处理授权结果。
- 支持批量输入，每个地址一行，必须以 https:// 开头，例如https://app.example.com/callback。
注意- 部分客户端类型无需配置该参数，请以控制台显示为准。
- 若配置，需确保与应用实际域名一致。
启用开发模式是否开启客户端的开发模式：- 关闭：（默认）仅允许使用 HTTPS 协议，保证 AgentKit 用户身份管理的配置安全性。
- 开启：需要进行本地开发，或者您期望将用户重定向到除 HTTPS 之外的其他协议，则必须启用开发模式。
- 单击“确定”按钮，创建完成客户端。
- 系统将为您生成客户端 ID（Client ID）和客户端密钥（Client Secret）。您可以在应用中配置这两个参数作为客户端的身份标识和密钥。
- Client ID：客户端身份的唯一标识符，用于在身份验证请求中标识客户端应用。
- Client Secret：客户端身份的密钥，用于在身份验证请求中验证客户端身份。
注意
Client Secret 仅在可信服务端按相应客户端类型使用，不得写入前端代码或安装包。
其他操作
成功创建客户端后，可查看、编辑、开发和管理客户端。
在客户端列表中，单击任意客户端的名称，即可进入其详情页面。详情页展示客户端的详情，如 Client ID、Client Secret、回调 URL 等。
在客户端列表的“操作”列，单击“编辑按钮”，即可修改当前客户端的相关信息。
说明
客户端类型以及创建后自动生成的“客户端 ID”和“客户端密钥”在创建后不可更改。
在客户端列表的“操作”列中单击“删除”按钮，在系统弹出的对话框中确认客户端名称并再次单击“删除”按钮后将永久删除客户端及其配置。
注意
删除客户端操作不可逆，请谨慎操作。
AgentKit 兼容标准的 OIDC 协议，您可以使用任何语言的 OIDC 客户端库（如 Python 的 authlib，Node.js 的 openid-client）进行集成。
在客户端详情页面的“快速开发”页签，根据实际业务场景选择开发平台后，按照控制台提示的开发步骤配置客户端信息，安装依赖，实现登录逻辑并验证开发结果。
最近更新时间：2026.11.02 20:29:35
这个页面对您有帮助吗？
有用
有用
无用
无用