邮箱 / 手机号 / 用户名注册
用户注册是用户参与你的应用的第一步。Logto 支持多种注册方式,包括用户名密码、邮箱或手机号验证、社交注册 和 企业单点登录 (SSO)。你可以根据应用需求设置最合适的注册方式。
访问 控制台 > 登录体验 > 注册与登录 开始配置标识符注册流程。

设置注册标识符
为了在 Logto 中成功创建新用户账户,用户必须提供至少一个标识符,以在 Logto 系统中唯一标识他们。第一步,选择用户在注册过程中必须提供的标识符。可选项包括:
在注册过程中收集的所有标识符,在同一租户下必须是唯一的。它们会被存储在用户资料中,并可用于登录集成了 Logto 的应用。
如果未选择任何标识符,则适用于仅 社交 或仅 企业单点登录 (SSO) 的注册方式。
你可以调整注册标识符的顺序,以优先让用户首先填写你想要的标识符。这个顺序会体现在注册流程中,第一个标识符会出现在初始注册界面,其余的会在后续步骤收集。
设置注册验证设置
为确保用户注册及后续登录过程的安全,你还需要为注册过程中收集的标识符配置验证设置。可用设置包括:
- 创建密码: 要求用户在注册时创建一个符合你登录体验设置中密码策略的密码。该密码与用户标识符一起作为登录应用的凭证。如果你将 用户名 设为注册标识符,则此项会自动启用,因为 用户名 只能与密码配合才能有效验证用户身份。密码策略 可根据你的安全需求自定义。
- 注册时验证:要求用户在注册时验证邮箱地址或手机号。目前,Logto 只接受已验证的邮箱和手机号作为标识符。当 邮箱地址 或 手机号 作为注册标识符时,此项会自动启用。用户必须在注册过程中输入发送到邮箱或手机号的验证码以确认归属权。
标识符 | 创建用户密码 | 注册时验证 |
---|---|---|
用户名 | 可选 | 不适用 |
邮箱地址 | 可选 | 必须 |
手机号 | 可选 | 必须 |
邮箱或手机号 | 可选 | 必须 |
注册流程示例
类型 1:用户名 + 创建密码
选择 用户名 作为注册标识符。创建密码会自动启用。

类型 2:邮箱地址或手机号 + 验证流程
选择 邮箱地址或手机号 作为注册标识符。注册时验证 强制启用。

类型 3:邮箱地址 + 验证 + 创建密码
选择 邮箱地址 作为注册标识符。注册时验证 强制启用。启用 创建密码,要求用户在注册时创建密码。(手机号注册流程同理)

类型 4:邮箱地址 + 验证 + 用户名 + 创建密码
选择 邮箱地址 和 用户名 作为注册标识符。注册时验证 强制启用。启用 创建密码,要求用户在注册时创建密码。

使用社交或企业单点登录 (SSO) 注册
除了这些传统的标识符注册方式,Logto 还支持通过社交和企业单点登录 (SSO) 身份提供商进行无密码注册,让用户注册流程更加顺畅和友好。
一旦在 Logto 配置并启用了 社交连接器 或 企业单点登录 (SSO) 连接器,用户即可使用已有的社交或企业身份便捷注册。社交和企业单点登录 (SSO) 注册方式允许用户跳过创建密码或验证邮箱 / 手机号等额外步骤。Logto 会自动通过已验证的社交或企业身份同步用户信息,并存储到用户资料中。
查看 社交登录 和 企业单点登录 (SSO) 章节,了解更多社交和企业单点登录 (SSO) 注册流程。
注意:如需自定义注册流程,请参考 自定义 UI (Bring your UI) 功能。
注册时收集更多用户信息
如需在注册时收集更多用户资料信息(如姓名、生日、公司名等),你有两种灵活选择:
方式一:收集用户资料
将 Logto 预置的“告诉我们你的信息”步骤直接加入注册流程。用户需填写所有必填项后才能完成注册。此方式无需编码,开箱即用。
通过 控制台 > 登录体验 > 收集用户资料 配置,选择预设基础数据字段或自定义字段并灵活校验。了解更多:收集用户资料
方式二:自托管引导流程
注册成功后将用户重定向到你自定义的引导流程,实现完全自定义的数据收集体验。此方式让你完全掌控用户体验,支持复杂的多步骤引导。
可通过 Account API 编程方式管理用户资料数据。
常见问题
网站内嵌注册表单
Logto 目前不支持无界面 API 进行注册和登录。你可以使用 自定义 UI (Bring your UI) 功能上传自定义注册表单,或通过登录参数将用户信息从你的网站传递到 Logto。了解更多用户标识符传递方式:认证 (Authentication) 参数。
向新用户发送欢迎邮件
订阅 User.Created
webhook 事件,向新用户发送欢迎邮件。了解更多 webhook 事件。