使用 Twilio SMS 设置短信验证
Logto 的官方 Twilio 短信服务连接器。
在本指南中，我们假设你对 Logto 连接器 (Connectors) 有基本的了解。如果没有，请查看 配置连接器 指南以开始了解。
开始使用
Twilio 提供用于拨打和接听电话、发送和接收短信以及其他通信功能的可编程通信工具。我们可以通过其 Web 服务 API 发送“验证码”短信。
注册 Twilio 账户
在 Twilio 上创建一个新账户。（如果你已经有账户，请跳到下一步。）
设置发件人的电话号码
访问 Twilio 控制台页面 并使用你的 Twilio 账户登录。
在“Phone Numbers” -> “Manage” -> “Buy a number”下购买一个电话号码。
ℹ️ 提示
有时你可能会遇到特定国家或地区不支持短信服务的情况。选择其他地区的号码以绕过此问题。
一旦我们拥有一个有效的号码，导航到“Messaging” -> “Services”。点击按钮创建一个新的消息服务。
给出一个友好的服务名称，并选择 Notify my users 作为我们的服务目的。
在下一步中，选择 Phone Number 作为 Sender Type，并将我们刚刚申请的电话号码添加到此服务中作为发件人。
ℹ️ 注意
每个电话号码只能与一个消息服务关联。
获取账户凭证
我们需要 API 凭证来使连接器工作。让我们从 Twilio 控制台页面 开始。
点击右上角的“Account”菜单，然后进入“API keys & tokens”页面获取你的 Account SID 和 Auth token。
返回从侧边栏开始的“Messaging” -> “Services”设置页面，找到你的服务的 Sid。
编写连接器 JSON
用相应消息服务的 Account SID、Auth token 和 Sid 填写 accountSID、authToken 和 fromMessagingServiceSID 字段。
你可以为不同的情况添加多个 SMS 连接器模板。以下是添加单个模板的示例：
- 用任意字符串类型的内容填写
content字段。不要忘记为随机验证码保留{{code}}占位符。 - 用
Register、SignIn、ForgotPassword、Generic中的一个填写usageType字段，以适应不同的使用场景。为了启用完整的用户流程，需要使用Register、SignIn、ForgotPassword和Generic的模板。
测试 Twilio SMS 连接器
你可以输入一个电话号码并点击“Send”以查看设置是否可以在“Save and Done”之前工作。
就是这样。别忘了 在登录体验中启用连接器 。
配置类型
| 名称 | 类型 |
|---|---|
| accountSID | string |
| authToken | string |
| fromMessagingServiceSID | string |
| templates | Templates[] |
| 模板属性 | 类型 | 枚举值 |
|---|---|---|
| content | string | N/A |
| usageType | enum string | 'Register' | 'SignIn' | 'ForgotPassword' | 'Generic' |