用户池（User Pool）是 AgentKit 管理用户身份和认证体验的基本边界。您可以为不同业务、应用或用户群创建独立的用户池，并分别配置登录、注册、账号找回和品牌展示方式。用户、应用客户端和外部身份连接都归属于具体的用户池，并使用该用户池的认证配置。

用户池可以管理什么

客户端（Client）：接入用户池的应用程序（如手机 App、企业官网等），需提前在用户池内创建并管理，获得唯一标识（客户端 ID）后才能使用用户身份系统的认证服务（如登录、获取令牌）。

身份源（IdP）：支持第三方账号登录（如飞书、Google 等），用户池会同步第三方账号信息（如头像、昵称），可连接 OIDC、OAuth、SAML、企业微信等外部身份系统。

操作步骤

配置项	说明
基本信息
用户池名称	自定义设置用户池名称。该名称属于用户池唯一标识符，成功创建用户池后不支持更新，因为后续被客户端、Token Issuer 等强引用，改名会导致大量下游业务失效。
用户池属性配置
用户池登录属性	选择登录用户池时使用的身份标识，例如：用户名、手机号、邮箱等。假设此处配置了用户名、手机号，则实际用户登录应用的时候必须填写用户名和手机号信息。注意此配置创建后不可修改。除默认用户名外，请至少选一个邮箱或手机号作为必需属性，否则用户忘记密码后无法自助找回。
用户池注册属性	选择用户注册时必须提供的身份标识，例如：用户名、手机号、姓名等。假设此处配置了用户名、手机号，则实际用户注册应用的时候必须填写用户名和手机号信息。注意注册属性默认包含所有登录属性，且不可更改。
资源管理
所属项目	为用户池指定所属项目，从项目维度管理用户池资源的运维、授权等操作。默认选择 default（默认项目）。更多项目相关操作和说明，请参见项目管理。
标签	为用户池添加标签，用于资源的分类和筛选。更多标签相关操作和说明，请参见标签管理。单击“添加标签”按钮可以新增一个键值对。最多可添加 20 个标签。

OIDC 发现端点：OIDC 协议的发现端点，用于 OIDC 协议的客户端获取用户池的相关信息。包含了关于如何与您的用户池进行 OIDC 交互的所有元数据，如授权端点、令牌端点、公钥信息等。当您要将此用户池作为身份提供商供其他应用或服务集成时，通常需要提供这个 URL。

后续操作

创建用户池后，页面会返回新建成功的提示信息。您可以在页面上直接为用户池关联客户端，并配置用户信息，以确保用户池能够正常工作。

其他操作

成功创建用户池后可查看、编辑、管理用户池，或为用户池创建新的第三方登录来源。

查看和编辑用户池

新建登录来源

删除用户池

查看：在用户池列表中，单击任意用户池的名称，即可进入其详情页面。详情页会展示用户池的基础信息、OIDC 发现端点、回调 URL 以及关联的客户端、用户和外部身份提供商等。

说明