短信模板
Logto 提供了四种不同的短信内容自定义模板,根据使用类型分为:Register、SignIn、ForgotPassword 和 Generic。强烈建议你针对不同的使用场景使用不同的模板,否则可能会触发限流,导致服务暂时不可用。
短信模板类型及示例
以下示例仅供参考:
usageType | 场景 | 模板示例 |
---|---|---|
SignIn | 用户使用手机号登录,并通过输入短信验证码而不是密码进行验证。 | Logto 登录验证代码:{{code}} 。10 分钟内有效。 |
Register | 用户使用手机号注册账号,并通过输入 Logto 发送到其手机号的验证码进行验证。 | Logto 注册验证代码:{{code}} 。10 分钟内有效。 |
ForgotPassword | 如果用户在登录时忘记密码,可以选择先通过手机号验证身份以重置密码。 | Logto 密码重置验证代码:{{code}} 。10 分钟内有效。 |
Generic | 此模板可作为多种场景的通用备选方案,包括测试连接器配置、登录后验证或绑定手机号等。 | Logto 验证码:{{code}} 。10 分钟内有效。 |
OrganizationInvitation | 使用此模板向用户发送邀请链接,邀请其加入组织 (Organization)。 | Logto 组织 (Organization) 邀请验证代码:{{code}} 。10 分钟内有效。 |
UserPermissionValidation | 在应用使用过程中,某些高风险操作或风险等级较高的操作可能需要额外的用户验证,如银行转账、删除正在使用的资源、取消会员等。UserPermissionValidation 模板可用于定义这些场景下用户收到的短信验证码内容。 | Logto 验证码:{{code}} 。10 分钟内有效。 |
BindNewIdentifier | 当用户修改个人资料时,可能会将手机号绑定到当前账号。此时可使用 BindNewIdentifier 模板自定义验证短信内容。 | Logto 账号绑定验证代码:{{code}} 。10 分钟内有效。 |
MfaVerification | 启用短信多因素认证 (MFA) 时,此模板用于在多因素认证 (MFA) 过程中向用户发送验证码。 | Logto 两步验证代码:{{code}} 。10 分钟内有效。 |
BindMfa | 启用短信多因素认证 (MFA) 时,此模板用于设置 MFA 的短信验证码。用户在将手机号作为 MFA 因素绑定或配置到账号时会收到此验证码。 | Logto 添加两步验证代码:{{code}} 。10 分钟内有效。 |
请注意以下参数:
- 验证码有效期为 10 分钟。目前暂不支持自定义过期时间。
- Logto 会将短信模板中的
{{code}}
占位符替换为验证码。因此,请确保模板中预留了该占位符。
备注:
由于合规要求,部分国家和地区可能不允许通过短信发送未审批的内容。短信模板需在短信服务商处注册并审核通过后方可使用。在这种情况下,内容可能会通过模板 ID 索引到对应模板。