使用 Tencent 短信服務設定簡訊驗證

Logto 的官方 Tencent 短信服務連接器。

提示:

本指南假設你已對 Logto 連接器 (Connectors) 有基本了解。若不熟悉，請參閱 連接器 (Connectors) 指南以開始使用。

開始使用

Tencent Cloud 是亞洲主要的雲端服務提供商，提供多種服務，包括 SMS（短訊服務）。

Tencent 短信服務連接器是 Logto 的官方整合，幫助終端使用者使用簡訊驗證碼註冊或登入。

在 Tencent Cloud 中設定短訊服務

建立 Tencent Cloud 帳戶

前往 Tencent Cloud 網站 並註冊帳戶（如果你還沒有帳戶）。

啟用並配置 Tencent Cloud SMS

1. 使用你的帳戶登入 Tencent Cloud 網站，並前往 SMS 服務控制台頁面。
2. 在 SMS 服務頁面上點擊「免費試用」按鈕，並按照設定步驟進行。
3. 同意「短信開通服務條款」，然後點擊「開通服務」以繼續。
4. 在「短信服務控制台概覽」中，根據需求從側邊欄選擇「國內消息」或「國際/港澳台消息」。
5. 為短信新增簽名和模板。注意：
   • 新增「簽名」時，在「適用場景」欄位選擇「驗證碼」。
   • 新增模板時，選擇「驗證碼」作為模板類型。
   • 在模板內容中包含一個佔位符 {1}，將由隨機生成的代碼替換。
   • 不支援多個佔位符的模板。請使用或創建單一佔位符模板。
6. 提交簽名和模板以供審核。提交後：
   • 等待其生效。
   • 可以從「短信服務控制台概覽」發送測試短信。已批准的簽名和模板可直接用於測試，或在審核中使用提供的測試模板。
   • 確保你的帳戶有足夠的餘額進行測試，並預先註冊測試手機號碼以成功接收短信。

如需詳細指導，請點擊 SMS 控制台概覽中的「新手配置指引」標籤。

編寫連接器 JSON

1. 前往「短信服務控制台概覽」，將滑鼠懸停在右上角的頭像上。導航至「訪問管理 > 訪問密鑰 > API 密鑰」，完成安全驗證後生成你的 AccessKey ID 和 AccessKey Secret。請妥善保管。
2. 從「國內消息」或「國際/港澳台消息」標籤中，檢索「簽名名稱」和「模板代碼」。
   • 對於測試模板，請檢查「快速開始」標籤下的「測試專用簽名模板」。

• 使用以下欄位配置 Tencent Cloud SMS 連接器：
  • accessKeyId 和 accessKeySecret：使用步驟 1 中的憑證。
  • signName：步驟 2 中獲得的簽名名稱。適用於所有模板。
  • 根據需要為不同場景添加多個模板。單一模板範例：
    • templateCode：從步驟 2 中的「模板代碼」檢索。
    • usageType：為不同場景指定 Register、SignIn、ForgotPassword 或 Generic（Logto 特定屬性）。
    • 確保為所有四個場景配置模板以完成流程。
  • sdkAppId：在「應用管理」中找到。
  • region：從「發送文檔」中指定支援的地區。

測試 Tencent Cloud SMS 連接器

你可以輸入一個電話號碼並點擊「發送」以查看設置是否能在「保存並完成」之前正常運作。

就是這樣。別忘了 在登入體驗中啟用連接器。

配置類型

名稱	類型
accessKeyId	string
accessKeySecret	string
signName	string
region	string
sdkAppId	string
templates	Template[]

Template 屬性	類型	枚舉值
templateCode	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'

參考資料

如何實現短信驗證碼功能？