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

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

提示:

在本指南中，我们假设你对 Logto 连接器 (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'

参考资料

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