文档中心

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

用户身份管理

用户池使用指南

用户池是 Identity 管理用户身份和认证体验的基本边界。您可以为不同业务、应用或用户群创建独立的用户池，并分别配置登录、注册、账号找回和品牌展示方式。

能力

用户池可以管理什么

一个用户池集中管理一组用户及其身份体验。用户、应用客户端和外部身份连接都归属于具体的用户池，并使用该用户池的认证配置。

用户池（User Pool）：管理用户身份的逻辑容器，包含用户账号、客户端信息及身份提供商管理三大模块

用户（User）：拥有唯一身份标识符的自然人或系统账号，包含基础属性（邮箱、手机号）。

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

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

认证体验：统一配置登录、注册、验证、账号找回和品牌展示。

运行时信息：提供应用接入和外部身份连接所需的域名、Issuer、Discovery URL 和回调地址。

配置用户登录方式

您可以根据业务场景选择一种或多种登录方式：

密码登录：用户使用用户名、邮箱或手机号配合密码登录。

短信验证码登录：用户通过手机号和短信验证码完成登录。

邮箱验证码登录：用户通过邮箱和验证码完成登录。

外部身份登录：通过配置连接，让用户使用企业身份系统或第三方身份提供商登录。

配置用户注册与验证

用户池支持管理员预先创建用户，也支持由用户自行完成注册。启用自助注册后，您可以进一步决定：

注册时需要填写哪些用户资料。

是否在注册过程中自动验证邮箱或手机号。

是否允许用户通过短信验证码快速完成注册。

配置账号找回

对于使用用户池本地账号的用户，可以启用自助账号找回。启用后，用户可通过已验证的邮箱或手机号完成身份验证和密码找回。

配置品牌展示

您可以为用户池设置品牌名称和 Logo，使托管登录、注册等页面与业务品牌保持一致。如果不同业务需要展示不同品牌，可以使用不同的用户池分别管理。

启用或停用用户池

用户池可以独立启用或停用。需要临时停止该用户池的身份服务时，可以停用用户池，而不必立即删除其中的配置和资源。

在控制台中完成配置

控制台中的用户池信息页面用于查看用户池基本信息、运行时地址和接入信息；身份验证页面用于配置登录、注册、验证和账号找回能力。

核心组件

用户池（User Pool）：管理用户身份的逻辑容器，包含用户账号、客户端信息及身份提供商管理三大模块

用户（User）：拥有唯一身份标识符的自然人或系统账号，包含基础属性（邮箱、手机号）。

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

外部身份提供商（IdP）：支持第三方账号登录（如飞书、Google 等），用户池会同步第三方账号信息（如头像、昵称）。

前提条件

你已开通智能体身份和权限管理平台服务，相关操作可参考开通智能体身份和权限管理平台并完成授权。

操作步骤

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

在左侧导航栏，选择身份管理 > 用户池。

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

配置用户池参数。

配置项	说明
用户池名称	必填。为你的用户池设置一个唯一的名称，例如 my-app-users。
描述	选填。简要描述该用户池的用途，例如“用于XX应用的内外部用户管理”。
用户池登录属性	选择用户登录时可以使用的身份标识。可选值：用户名、手机号、邮箱默认值：用户名、手机号注意此配置创建后不可修改。
用户池注册属性	选择用户注册时必须提供的身份标识。可选值：用户名、手机号、邮箱、姓名、名、姓、中间名等默认值：用户名、手机号
所属项目	选择用户池所属的项目，用于资源隔离和管理。可以从下拉列表中选择已有项目，或单击新建项目创建一个新项目。
标签	为用户池添加标签，用于资源的分类和筛选。单击添加标签可以新增一个键值对。最多可添加 20 个标签。

单击确定。

系统将自动为你创建一个新的用户池，并生成专属的用户池 ID、TRN 和 OIDC 发现端点。

TRN：资源统一标识，用于跨服务资源关联。

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

后续操作

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

创建客户端：单击页面新建客户端，为当前用户池关联客户端。相关操作可参见创建客户端。

创建用户：单击页面新建用户或批量导入，为当前用户池关联用户。相关操作可参见创建用户。

其他操作

查看与编辑用户池

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

编辑：在用户池列表的操作列或详情页右上角，单击编辑。目前仅支持修改用户池名称和描述信息。

说明

用户池的登录和注册属性、以及系统生成的其他标识在创建后不可更改。

删除用户池

在用户池列表的操作列，单击删除。系统会提示你进行二次确认。

注意

删除用户池是一个不可逆的操作。执行前，你必须先移除该用户池下关联的所有客户端和用户。

删除后，所有与该用户池相关的数据和配置都将被永久销毁，依赖于此用户池的应用将无法进行用户认证。

推荐接入流程

根据业务边界创建用户池，并设置名称和描述。

选择用户可使用的登录方式和登录标识。

确认是否允许自助注册，以及注册时需要收集的资料。

按需配置自动验证、账号找回和品牌信息。

在用户池中创建应用客户端，并按应用类型完成接入。

如需使用企业或第三方账号登录，在用户池中创建对应连接。

完成测试后，再将用户池用于正式业务。

用户池 API

用户池 API 覆盖创建、查询、更新、启停和删除等完整生命周期。以下 API 只负责用户池本身；用户、客户端、连接、自定义域名和自定义属性由各自的 API 管理。

API	使用场景	说明
CreateUserPool	创建用户池	创建新的身份边界，并设置初始的登录、注册、账号找回和品牌能力。创建成功后会返回用户池详情和唯一标识。
ListUserPools	查看用户池列表	分页查看当前账号下的用户池，可按名称、标识、描述、项目或标签进行筛选，并按名称或时间排序。
GetUserPool	查看用户池详情	获取一个用户池的完整配置、启用状态、运行时地址，以及用户、客户端和连接数量等信息。
UpdateUserPool	调整用户池配置	更新名称、描述、登录开关、注册能力、账号找回策略和品牌信息。只需传入本次需要修改的配置。
UpdateEnableUserPool	启用或停用用户池	单独控制用户池是否启用，适合临时停止或恢复用户池服务。
DeleteUserPool	删除用户池	永久删除用户池及其关联资源。该操作影响范围较大，执行前应确认不再有应用或用户依赖该用户池。

关键 API 参数

以下仅介绍与用户池能力直接相关的关键参数。调用不同 API 时，可根据实际目标选择需要配置的参数。

基本信息

参数	对应能力
Name、Description	用于识别和说明用户池，建议使用能够体现业务或环境的名称。
UserPoolUid	用户池的唯一标识。查询、更新、启停和删除指定用户池时使用。
ProjectName、Tags	用于对用户池进行项目归属和标签分类，便于资源管理和检索。

登录能力

参数	对应能力
PasswordSignInEnabled	控制是否允许使用密码登录。
SmsPasswordlessSignInEnabled	控制是否允许使用短信验证码登录。
EmailPasswordlessSignInEnabled	控制是否允许使用邮箱验证码登录。
SignInAttributes	指定用户可以使用邮箱、手机号或首选用户名中的哪些属性登录。该参数在创建用户池时配置。

注册与验证能力

参数	对应能力
SelfSignUpEnabled	控制用户是否可以自行注册。
RequiredSignUpAttributes	指定自助注册时必须填写的用户资料。该参数在创建用户池时配置。
SignUpAutoVerificationEnabled	控制注册过程中是否自动验证邮箱或手机号。
SmsAnonymousSignUpEnabled	控制是否支持通过短信验证码快速注册；使用该能力时需要同时启用短信验证码登录。

账号安全与找回

参数	对应能力
SelfAccountRecoveryEnabled	控制本地账号是否支持用户自助找回。
SelfAccountRecoveryVerificationAttributes	指定账号找回时可使用邮箱或手机号进行验证。启用自助找回时，需要配置至少一种验证属性。
UnconfirmedUserSignInEnabled	控制尚未完成确认的本地用户是否可以登录。

品牌与状态

参数	对应能力
Brand.Name、Brand.LogoUri	设置托管认证页面展示的品牌名称和 Logo。
Enabled	通过 UpdateEnableUserPool 启用或停用用户池。

列表查询

ListUserPools 使用 PageNumber 和 PageSize 控制分页；可通过 Filter、ProjectName 和 TagFilters 查找目标用户池，并使用 SortField 和 SortDirection 调整排序。

下一步

创建应用客户端并接入登录：OIDC 客户端使用指南

设计业务自定义用户资料：自定义属性 Schema

配置外部登录：连接

最近更新时间：2026.08.24 15:13:48

这个页面对您有帮助吗？

有用

无用