国际短信服务

RootAuth 支持为非中国大陆手机号配置国际短信验证码服务。开启后，国际手机号可用于注册、登录、重置密码和短信二次验证等场景。

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

 

1. 开始前准备

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

1. 是否需要开启国际短信服务。
2. 已确定使用 RootAuth 内置短信，还是自定义短信服务商。
3. 如果使用自定义服务商，已准备好服务商凭证、签名或 SenderId、模板 ID。
4. 已准备一个非 +86 的测试手机号。

 

2. 选择服务类型

在「服务类型」中选择短信服务商。默认选择「内置短信」。

服务类型	说明
内置短信	使用 RootAuth 内置国际短信服务，无需填写服务商凭证。
阿里云短信	使用您自己的阿里云国际短信服务。
腾讯云短信	使用您自己的腾讯云国际短信服务。
Ucloud短信	使用您自己的 Ucloud 国际短信服务。

 

3. 配置内置短信

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

点击「保存并发送测试短信」后，系统会打开「发送国际测试短信」弹窗。您可以选择区号并输入手机号进行测试。

国际测试短信不校验手机号格式，区号选项默认展示非 +86 的全球区号。

 

4. 配置阿里云短信

配置项	是否必填	说明
AccessKey ID	是	阿里云账号的 AccessKey ID。
AccessKey Secret	是	阿里云账号的 AccessKey Secret。
有效时间	是	验证码有效时间，单位为分钟。需与短信模板内容保持一致。
SenderId	否	国际短信发送方标识，如服务商要求可填写。
品牌标识	否	用于短信内容开头的品牌展示。各场景短信内容复用同一个品牌标识。
注册验证码模板 ID	是	用于注册场景的短信模板 ID。
登录验证码模板 ID	是	用于登录场景的短信模板 ID。
重置密码验证码模板 ID	是	用于重置密码场景的短信模板 ID。
二次验证码模板 ID	视情况必填	如果已开启短信 MFA 后再配置服务商，该模板 ID 必填。

阿里云国际短信的短信内容会遵循服务商规则，通常与内置短信内容保持一致，不支持为每个场景单独编辑短信正文。

 

5. 配置腾讯云短信

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

 

6. 配置 Ucloud 短信

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

 

7. 发送测试短信

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

在弹窗中选择短信模板、区号并输入手机号，然后点击「确定」。测试短信用于验证当前国际短信配置是否可正常发送。

 

8. 保存配置后的影响

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

如需限制用户可选择的区号，请前往「应用管理」→「登录控制」配置「手机号区号策略」。

 

9. 关闭或切换服务

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

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