使用腾讯短信服务设置短信验证

Logto 官方的腾讯短信服务连接器。

提示:

本指南假设你对 Logto 连接器 (Connectors) 有基本的了解。对于不熟悉的人，请参考 连接器 (Connectors) 指南以开始了解。

入门指南

腾讯云是亚洲主要的云服务提供商，提供包括短信（短消息服务）在内的多种服务。

腾讯短信服务连接器是 Logto 的官方集成，帮助终端用户通过短信验证码注册或登录。

在腾讯云中设置短信服务

创建腾讯云账号

前往 腾讯云官网 注册账号（如果你还没有的话）。

开通并配置腾讯云短信

1. 使用你的账号登录 腾讯云官网，并进入 短信服务控制台页面。
2. 在短信服务页面点击“免费试用”按钮，并按照设置步骤操作。
3. 同意“短信开通服务条款”，点击“开通服务”继续。
4. 在“短信服务控制台概览”页面，根据需求选择侧边栏的“国内消息”或“国际/港澳台消息”。
5. 添加短信签名和模版。注意事项：
   • 添加“签名”时，在“模版类型”字段选择“验证码”。
   • 添加模版时，选择“验证码”作为模版类型。
   • 在模版内容中包含占位符 {1}，该占位符将被随机生成的验证码替换。
   • 不支持包含多个占位符的模版。请使用或创建仅包含一个占位符的模版。
6. 提交签名和模版进行审核。提交后：
   • 等待其生效。
   • 可以在“短信服务控制台概览”页面发送测试短信。已通过审核的签名和模版可直接用于测试，若仍在审核中可使用测试专用模版。
   • 请确保你的账号余额充足，并预先登记测试手机号以便成功接收短信。

如需详细指导，请点击短信服务控制台概览中的“新手配置指引”标签。

编写连接器 JSON

1. 进入“短信服务控制台概览”，将鼠标悬停在右上角头像，导航至“访问管理 > 访问密钥 > API 密钥”，完成安全验证后生成你的 AccessKey ID 和 AccessKey Secret，请妥善保存。
2. 在“国内消息”或“国际/港澳台消息”标签下，获取“签名名称”和“模版 CODE”。
   • 测试专用模版可在“快速开始”标签下的“测试专用签名模版”中查看。

• 使用以下字段配置腾讯云短信连接器：
  • accessKeyId 和 accessKeySecret：使用第 1 步获取的凭证。
  • signName：第 2 步获取的签名名称，适用于所有模版。
  • 如有需要，可为不同场景添加多个模版。单个模版示例：
    • templateCode：在第 2 步获取的模版 CODE。
    • usageType：针对不同场景指定 Register、SignIn、ForgotPassword 或 Generic（Logto 专用属性）。
    • 请确保为所有四种场景配置了模版，以完成流程。
  • sdkAppId：在“应用管理”页面可查找。
  • region：在“发送文档”中指定支持的地域。

测试腾讯云短信连接器

你可以输入手机号并点击“发送”，在“保存并完成”前测试设置是否可用。

就是这样。别忘了在注册和登录中启用连接器。

配置类型

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

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

参考资料

如何实现短信验证码功能？