跳到主要内容

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

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

提示:

本指南假设你对 Logto 连接器 (Connectors) 有基本的了解。对于不熟悉的人，请参考 连接器 (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 的模板。

测试阿里云短信连接器​

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

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

配置类型​

名称类型
accessKeyIdstring
accessKeySecretstring
signNamestring
templatesTemplate[]
模板属性类型枚举值
templateCodestringN/A
usageTypeenum string'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'

参考资料​

阿里云短信 - 快速入门