文档中心

AgentKit

身份管理

配置身份验证信息

身份验证配置用于决定用户可以通过哪些凭证进入您的应用。您可以单独配置登录方式和注册方式。

前提条件

已创建用户池。相关操作，请参见创建用户池。

若使用短信服务配置，需提前创建发送短信相关的消息组。相关操作，请参见新增消息组。

如需配置钩子函数，需提前在函数服务创建 HTTP/S 事件函数。相关操作，请参见创建事件函数。

操作步骤

在左侧导航栏，选择“身份与权限 > 用户管理”，单击目标用户池名称。

在用户池详情页面，切换到“身份验证”页签。

配置身份验证相关参数。

短信服务配置：配置该用户池发送短信验证码所依赖的短信通道。

注意

使用短信服务，会产生对应的费用，详情请参见国内短信计费、国际及港澳台短信计费。

短信配置	说明
短信通道 / 供应商	选择该用户池走哪条短信发送链路，目前仅支持走平台内置短信服务“火山引擎-短信服务”通道，适用于发送量较大的生产环境，提供高可用保障。
适用地区	短信服务的适用地区：中国大陆地区：向中国大陆地区发送短信。该服务会产生国内短信计费。国际及港澳台：向国际及中国港澳台地区发送短信。该服务会产生国际及港澳台短信计费。
消息组	消息组主要用于资源隔离，您可通过不同的消息组区分短信类型、区分业务线等，不同消息组间的签名、模板和发送数据互相隔离。此处选择前提条件中准备的消息组。若无可用消息组，请创建消息组。相关操作，请参见新增消息组。
短信签名	中国大陆地区短信，需要配置短信签名。短信签名是位于短信正文前【】中的署名，用于标识公司或业务。相关操作，请参见新增签名和模板。
发送方	国际及中国港澳台地区短信，需要配置发送方。与短信签名类似，请填写短信的发送方，比如发送方公司名称。

登录方式：配置用户可以通过哪些方式登录您的应用。

登录方式	说明
密码登录	密码登录是最基础的登录方式。用户可使用“用户名/手机号/邮箱 + 密码”方式进行登录。为保证账户体系的基础可用性，系统默认强制开启。说明密码登录默认开启，不支持手动关闭，如需要关闭请联系管理员。
短信验证码登录	AgentKit 默认开启短信验证码登录方式，开启后用户输入手机号并接收验证码即可登录（免密）。

注册方式管理：控制新用户如何进入您的应用生态。

注册方式	说明
自助注册	开启时：开放式应用。任何访问登录页面的访客都可以自行注册新账号。关闭时：封闭式应用。登录页面将隐藏注册入口。新用户必须由管理员在 AgentKit 控制台用户池中手动创建，或通过 API 导入。
注册自动验证	注册自动验证功能主要用于验证目标手机号是否为注册人使用，可以防止攻击者用随机手机号/别人的手机号批量注册，有效降低机器人注册等情况。开启注册自动验证后，新用户注册时必须先收一条短信验证码、填对验证码，才算注册成功。说明开启“注册自动验证”功能的前提：需要配置好短信服务。

密码管理：配置密码找回能力。

配置项

说明

短信密码找回

开启短信密码找回后，用户在登录页点“忘记密码”，可以通过手机号 / 邮箱收验证码验证身份，然后自己设一个新密码，不必找管理员。

说明

开启“短信密码找回”功能的前提：需要配置好短信服务。

请确保用户账号里已经绑了手机号或邮箱，配合找回密码。

若开启“密码登录”，建议同步开启“短信密码找回”，否则用户忘密码只能找管理员重置，运营成本高。

扩展能力：为用户池配置更多身份验证扩展能力。

扩展能力

说明

钩子函数管理

钩子函数是挂在用户认证流程里的一段自定义代码，当用户注册、登录、即将签发令牌时，AgentKit 会同步调用您的函数，帮您实现标准产品能力以外的功能。

能力：

动态加 Claims：用户登录后，实时去公司的 HR 系统/CRM 查用户的部门、角色、会员等级，写进 ID Token / Access Token。下游 Agent 直接基于这些字段做权限判断。

登录风控：根据登录 IP、设备指纹、历史行为调整和风控引擎，对高风险用户直接拒绝签发令牌。

登录审计：每次登录/签发令牌时都在您自己的日志平台/SIEM 记录事件。

协议与字段转换：按下游系统要求改 Claim 的名字、格式、取值。

配置步骤：

在函数服务控制台创建一个事件函数，运行时选择您自己熟悉的 Node.js / Python / Go 等语言。相关操作，请参见创建事件函数。

给函数配一个 API 网关触发器，拿到公网可访问的 HTTPS 端点。相关操作，请参见创建 API 网关触发器。

在 AgentKit 控制台目标用户池的“身份验证”页签，单击“添加钩子函数”按钮，选择钩子函数类型、选刚建的函数服务事件函数并保存配置。

推荐配置组合

场景	自助注册	短信验证码登录	其他建议
内部员工（已接入飞书 / 钉钉等企业 SSO）	关	关	账号由 SSO 自动建。密码登录保留作为兜底。可开启密码找回功能。
外部合作伙伴 / 供应商	关（由管理员来注册）	可选	用单独的用户池隔离。绑 IAM 角色按组授权。
C 端产品用户	开	开	必须开“注册自动验证”。建议开启密码找回功能。可挂 Pre-Token Hook 注入会员等级。
POC / 测试	按需	按需	短信服务可以不配，减少短信费用相关开销。

最近更新时间：2026.10.26 17:42:29

这个页面对您有帮助吗？

有用

无用