登录控制

登录控制用于配置终端用户的登录和注册页面行为，包括页面布局、账号字段、认证方式和手机号区号策略。通过这些设置，您可以控制用户可以使用邮箱、手机号或用户名完成注册和登录。

路径：登录 RootAuth 控制台 → 进入目标应用 → 点击顶部导航栏的「配置」→「应用管理」→「登录控制」

 

1. 常规登录设置

在「常规登录」中，您可以配置登录注册页面布局、注册后自动登录、账号字段和手机号区号策略。

1.1 登录注册页面

模式	说明
登录注册分页	登录和注册为两个独立页面，用户先注册后登录。
登录注册合并	登录和注册在同一页面中完成，适合更简洁的认证体验。

 

1.2 注册后自动登录

开启后，用户注册成功会自动登录，并跳转至登录回调 URL。

关闭后，用户注册成功后需要手动返回登录流程。

此配置，只有在登录注册分页的模式下可开启。

 

2. 配置账号字段

账号字段用于控制用户可以使用哪些账号类型注册和登录。

账号字段	认证方式	用于登录	用于注册	说明
邮箱-email	密码	可开启	可开启	支持邮箱密码登录和注册。
邮箱-email	验证码	可开启	不可开启	支持邮箱验证码登录。
手机号-phone	密码	可开启	可开启	支持手机号密码登录和注册。
手机号-phone	验证码	可开启	不可开启	支持手机号验证码登录。
用户名-username	密码	可开启	可开启	支持用户名密码登录和注册。

2.1 勾选规则

• 如果某个账号字段开启「用于登录」，系统会自动开启对应的「用于注册」，如关闭则同时关闭。
• 在「用于登录」未开启的情况下，不支持单独开启「用于注册」。
• 可以只开启「用于登录」，不勾选「用于注册」。这种配置适用于仅允许已有账号登录、不允许新用户使用该字段注册的场景。
• 如所有「用于注册」未开启时，仅在前端禁止注册行为。

 

3. 手机号区号策略

当登录控制中启用手机号相关登录或注册能力时，可以配置手机号区号策略。

配置项	默认值	说明
允许注册/绑定区号	+86 中国	用户注册或在用户详情中绑定手机号时，只能选择这里配置的区号。
允许登录区号	全球	用户使用手机号登录时或用户首次使用短信 MFA 且需要绑定手机号时，只能选择这里配置的区号。

区号支持多选。可选范围包括 +86 中国、+852 中国香港、+853 中国澳门、+886 中国台湾 或单选「全球」。

 

如果注册区号和登录区号不一致，并且使用登录注册合并页面，登录注册页会按照「允许登录区号」展示可选区号。

 

4. 手机号唯一规则

手机号在当前应用内保持唯一。用户绑定手机号后，可以使用该手机号作为账号别名登录。

需要注意：

1. 已被绑定的手机号不能再次注册。
2. 已被其他账号使用的手机号不能绑定到当前用户。
3. 已被其他账号使用的邮箱也不能绑定到当前手机号账号。

当手机号或邮箱已存在时，系统会提示对应字段已存在。

 

5. 用户名配置

用户名配置用于控制非用户名注册方式下的用户名生成规则，以及用户名注册时允许使用的格式。

5.1 自动生成用户名

5.1.1 总开关

配置项	默认值	说明
是否自动生成用户名	关闭	开启后，用户选择邮箱或手机号等非用户名注册方式时，系统会在注册时自动生成随机用户名。

5.1.2 生成规则类型

开启自动生成用户名后，可通过 Tab 在以下两种方式之间切换：

方式	说明
前缀 + 随机组合	输入前缀后，系统在前缀末尾追加指定长度的随机字符。
自定义规则	输入包含 # 占位符的规则模板，系统会以随机字符替换 #。

5.1.3 前缀 + 随机组合

配置项	规则
前缀	非必填。仅支持字母、数字、下划线（_）和横杠（-），最多 20 个字符。不符合规则时显示红色错误提示。

5.1.4 自定义规则

配置项	规则
规则模板	必填。占位提示为「如 user-#」。支持字母、数字、* 和 -；# 为随机字符占位符。最多包含 1 个 #，除 # 外的规则长度不能超过 20 个字符。

5.1.5 公共配置

以下配置在两种生成方式下通用：

配置项	默认值	范围/规则
字符长度	12	可通过滑块或数字输入框设置，范围为 4 至 32。长度仅计算随机生成的字符，不包含前缀或规则模板中的固定字符。
字符类型	字母 + 数字	可选「字母 + 数字」「纯字母」或「纯数字」。

系统会实时显示生成的用户名示例，并提供「复制」按钮将预览内容复制到剪贴板。前缀模式的预览为「前缀 + 随机字符串」；自定义规则模式会以指定长度和字符类型的随机字符串替换 #。

 

5.2 用户名注册格式配置

该配置固定以收起状态显示，不依赖「用户名 - 密码」认证方式的「用于注册」开关是否开启。

配置项	默认值	规则
字符长度范围 - 最小	4	最小值为 4。输入小于 4 时显示红色提示「最小长度不能小于4」。
字符长度范围 - 最大	52	最大值为 52。输入大于 52 时显示红色提示「最大长度不能超过52」。
格式规则	字母 + 数字	可选「字母 + 数字」「纯字母」或「纯数字」。
允许特殊字符（-、_）	关闭	开启后，用户名可以包含横杠（-）和下划线（_）。

通过用户名方式注册、创建用户时创建用户名的账号，在用户详情添加用户名，都遵循同一套格式配置。

 

6. 体验注册/登录

完成应用配置后，您可以通过页面右上角的 “体验注册/登录” 按钮，预览当前应用的登录注册页面效果。

体验页面将严格遵循以下配置：

• 登录控制中勾选的认证方式

• 应用配置中的 Logo 和应用名称

• 安全设置中的注册安全设置（如验证码、注册限制等）

• 协议配置中的授权模式（仅影响OIDC流程，体验页面不涉及授权交互）

此功能可用于快速验证配置是否符合预期，确保上线前体验流畅无误。

应用配置修改后，在体验页面和终端用户页面最多需要 2 分钟生效。