使用阿里云短信服务设置短信验证

Logto 官方的阿里云短信服务连接器。

提示

在本指南中，我们假设你对 Logto 连接器 (Connectors) 有基本的了解。如果没有，请查看 配置连接器 指南以开始了解。

开始使用

阿里云是亚洲主要的云服务提供商，提供包括短信（短消息服务）在内的多种云服务。阿里云短信连接器是 Logto 团队提供的一个插件，借助它，Logto 终端用户可以通过短信验证码注册和登录他们的 Logto 账户。

在阿里云短信控制台中设置短消息服务

💡 提示

如果你已经完成某些部分，可以跳过。

创建阿里云账户

如果你还没有阿里云账户，请访问 阿里云网站 并注册你的阿里云账户。

启用并配置阿里云短信服务

1. 使用你的阿里云账户登录 阿里云网站，并进入 短信服务控制台页面。
2. 点击短信服务页面左上角的“免费开通”按钮，开始配置过程。
3. 阅读并同意“短信服务开通条款”，然后点击“开通服务”继续。
4. 现在你在 短信服务控制台页面，根据你的使用场景，进入侧边栏的“国内消息”或“国际/港澳台消息”按钮。
5. 按照指南添加签名和模板，并提供审核所需的材料或信息。
   • 在填写签名申请时，记得选择“验证码”作为“适用场景”，在申请模板审核时也选择“验证码”作为“模板类型”，因为我们使用这些签名和模板发送验证码。目前，我们不支持发送除验证码相关文本消息以外的短信。
   • 在模板内容中使用 {{code}} 作为占位符，以放置你的数字验证码。
6. 提交短信签名和模板申请后，你需要等待其生效。此时，我们可以返回 短信服务控制台页面 并发送测试短信。如果你的签名和模板已准备好使用，可以直接尝试；如果尚未生效，阿里云也提供测试模板。
   • 在发送测试消息之前，你可能需要充值少量金额。
   • 在发送测试消息之前，你可能还需要绑定一个测试电话号码。更多详情，请访问 短信服务控制台页面 侧边栏的“快速学习”选项卡。

编写连接器 JSON

1. 在 短信服务控制台页面，将鼠标悬停在右上角的头像上，进入“AccessKey 管理”，并点击“创建 AccessKey”。完成安全验证后，你将获得一对“AccessKey ID”和“AccessKey Secret”。请妥善保管。
2. 进入你刚访问的“国内消息”或“国际/港澳台消息”选项卡，你可以轻松找到“签名名称”和“模板 CODE”。
   • 如果你想使用仅供测试的签名和模板，请改为进入“快速学习”选项卡，你将在“签名和模板（仅供测试）”下找到它们。
3. 填写阿里云短信连接器设置：
   • 使用步骤 1 中获得的访问密钥对填写 accessKeyId 和 accessKeySecret 字段。
   • 使用步骤 2 中提到的“签名名称”填写 signName 字段。所有模板将共享此签名名称。
   • 你可以为不同的情况添加多个短信连接器模板。以下是添加单个模板的示例：
     • 使用步骤 2 中的“模板 CODE”填写 templateCode 字段，以控制短信内容。
     • 根据不同的使用场景，使用 Register、SignIn、ForgotPassword 或 Generic 填写 usageType 字段。(usageType 是 Logto 属性，用于识别适当的使用场景。) 为了启用完整的用户流程，需要具有 Register、SignIn、ForgotPassword 和 Generic 的 usageType 的模板。

测试阿里云短信连接器

你可以输入一个电话号码并点击“发送”以查看设置是否能在“保存并完成”之前工作。

就是这样。别忘了 在登录体验中启用连接器。

配置类型

名称	类型
accessKeyId	string
accessKeySecret	string
signName	string
templates	Template[]

模板属性	类型	枚举值
templateCode	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'

参考资料

• 阿里云短信 - 快速学习