国内短信服务

RootAuth 支持为国内手机号配置短信验证码服务。配置后，注册验证码、登录验证码、重置密码验证码以及短信二次验证等短信，将按照当前应用的短信服务设置发送。

路径：登录 RootAuth 控制台 -> 进入目标应用 -> 点击顶部导航栏的「配置」->「品牌化」->「短信」-> 选择「国内短信服务」

1. 开始前准备

配置国内短信服务前，请先确认：

1. 已确定要使用 RootAuth 内置短信，还是自定义短信服务商。
2. 如果使用自定义服务商，已在对应平台准备好 AccessKey、Secret、签名和短信模板 ID。
3. 如应用已开启「短信验证」多因素认证，请同时准备「二次验证码」模板 ID。
4. 已准备一个国内手机号，用于发送测试短信。
   
   

2. 选择服务类型

进入「国内短信服务」后，在「服务类型」中选择短信服务商。

服务类型	说明
内置短信	使用 RootAuth 内置短信服务，无需填写服务商凭证。默认选择「内置短信」。
阿里云短信	使用您自己的阿里云短信服务发送国内短信。
腾讯云短信	使用您自己的腾讯云短信服务发送国内短信。
Ucloud 短信	使用您自己的 Ucloud 短信服务发送国内短信。

 

3. 使用内置短信

选择「内置短信」后，无需填写额外字段。RootAuth 会使用内置短信服务发送国内短信验证码。

您可以选择：

1. 点击「保存」，仅保存当前配置。
2. 点击「保存并发送测试短信」，在弹窗中输入国内手机号，发送测试短信。

发送国内测试短信时，系统会校验手机号格式。测试短信用于确认当前模板和发送链路是否可用。

4. 配置阿里云短信

选择「阿里云短信」后，填写以下信息：

配置项	是否必填	说明
AccessKey ID	是	阿里云账号的 AccessKey ID。
AccessKey Secret	是	阿里云账号的 AccessKey Secret。
有效时间	是	验证码有效时间，单位为分钟。需与短信模板内容保持一致。
签名	是	已审核通过的短信签名。
注册验证码模板 ID	是	用于注册场景的短信模板 ID。
登录验证码模板 ID	是	用于登录场景的短信模板 ID。
重置密码验证码模板 ID	是	用于重置密码场景的短信模板 ID。
登录二次验证码模板 ID	视情况必填	如果已开启短信 MFA 后再配置服务商，该模板 ID 必填。

5. 配置腾讯云短信

选择「腾讯云短信」后，填写以下信息：

配置项	是否必填	说明
SdkAppId	是	腾讯云短信应用的 SdkAppId。
SecretKey	是	腾讯云账号的 SecretKey。
SecretId	是	腾讯云账号的 SecretId。
Region ID	是	选择短信服务所在区域，如华北、华南、华东地区。
有效时间	是	验证码有效时间，单位为分钟。需与短信模板内容保持一致。
签名	是	短信签名内容，不是签名 ID。
注册验证码模板 ID	是	用于注册场景的短信模板 ID。
登录验证码模板 ID	是	用于登录场景的短信模板 ID。
重置密码验证码模板 ID	是	用于重置密码场景的短信模板 ID。
二次验证码模板 ID	视情况必填	如果已开启短信 MFA 后再配置服务商，该模板 ID 必填。

 

6. 配置 Ucloud 短信

选择「Ucloud短信」后，填写以下信息：

配置项	是否必填	说明
PublicKey	是	Ucloud 账号的公钥。
PrivateKey	是	Ucloud 账号的密钥。
有效时间	是	验证码有效时间，单位为分钟。需与短信模板内容保持一致。
签名	是	短信签名内容，不是签名 ID。
ProjectId	否	当前账号下指定项目的 ID。
注册验证码模板 ID	是	用于注册场景的短信模板 ID。
登录验证码模板 ID	是	用于登录场景的短信模板 ID。
重置密码验证码模板 ID	是	用于重置密码场景的短信模板 ID。
登录二次验证码模板 ID	视情况必填	如果已开启短信 MFA 后再配置服务商，该模板 ID 必填。

 

7. 发送测试短信

点击「保存并发送测试短信」后，系统会打开「发送国内测试短信」弹窗。

在弹窗中选择短信模板，输入国内手机号，然后点击「确定」。如果短信发送成功，测试手机号将收到 RootAuth 发送的验证码短信。

 

8. 保存配置后的影响

保存成功后，当前应用的国内短信验证码会按照所选服务商发送。配置会影响注册、登录、重置密码以及短信二次验证等使用国内手机号的场景。

如果切换服务商，新的配置在保存后生效。请在上线前发送测试短信，确认凭证、签名和模板 ID 均可用。

9. 关闭或切换服务

国内短信服务没有单独关闭开关。如需停止使用自定义服务商，可以将服务类型切换为「内置短信」并保存。

切换后，历史用户手机号和已绑定的短信验证记录不会被删除。