跳至主要內容

SMS 連接器

配置 SMS 連接器可以將 一次性密碼 (OTPs) 發送到使用者的手機號碼。這種無密碼驗證機制可用於多種情境，包括註冊、登入、忘記密碼、連結帳戶流程、成員邀請和驗證使用者身分。它簡化了使用者驗證並通過減少與密碼相關的漏洞風險來增強安全性。

選擇你的 SMS 連接器​

Logto 提供了一些內建的 SMS 連接器，允許即開即用：

如果我們的標準連接器無法滿足你的特定需求，請隨時聯繫我們。對於 Logto OSS 使用者，如果需求緊急，你可以實作你的連接器 (OSS)。我們始終歡迎貢獻；你的努力可能會幫助其他有相同需求的社群成員。

配置步驟​

按照以下步驟新增 SMS 連接器：

  1. 前往 控制台 > 連接器 > 電子郵件和 SMS 連接器。
  2. 要新增 SMS 連接器，點擊「設定」按鈕並選擇你想要的 SMS 提供商。
  3. 查看所選提供商的 README 文件。
  4. 在「參數配置」部分填寫所需欄位。
  5. 使用 JSON 編輯器自訂 SMS 模板。
  6. 使用「通用」模板發送驗證碼到你的手機來測試配置。
  7. 點擊「儲存並完成」以完成。

更改 SMS 連接器​

要更改為其他 SMS 連接器：

  • 訪問連接器詳細資訊頁面，然後點擊右上角的「更改連接器」
  • 或者，刪除現有連接器並創建新的連接器

注意：你只能啟用一個 SMS 連接器。

當你已經有一個 SMS 連接器時，你只能選擇「更改 SMS 連接器」。在控制台執行此操作時，保存後立即生效，因此請務必在保存前測試你的配置。

為確保服務的穩定性，Cloud 使用者可以為開發環境創建一個 開發租戶。在開發環境中測試配置後，將配置「遷移」到生產環境，然後保存設置。

啟用手機號碼註冊或登入​

成功新增 SMS 連接器並完成配置後，你可以根據業務需求啟用依賴手機 + 驗證碼的登入和註冊配置。

  1. 前往：控制台 > 登入體驗 > 註冊和登入
  2. 設置註冊方法：選擇「手機號碼」或「電子郵件地址或手機號碼」作為註冊識別符。注意：目前註冊時手機號碼驗證是必須的。
  3. 設置登入方法：選擇的註冊識別符自動成為登入方法。點擊「新增其他」以獲得更多登入選項。
  4. 保存更改並測試：點擊「保存更改」以實施新的登入體驗。記得使用「即時預覽」來測試功能。
注意:

由於我們的配置立即生效，刪除現有 SMS 連接器可能會影響終端使用者的正常登入和註冊流程。

例如，如果登入識別符包含「手機號碼 + 驗證碼」組合，刪除現有 SMS 連接器將阻止使用者通過電子郵件接收驗證碼，並導致登入流程出錯。

請在操作連接器時注意潛在風險。

常見問題​

Logto 沒有我想使用的 SMS 連接器。我該怎麼辦？​

我們仍在開發更多連接器。如果你需要更多選擇，請在 Discord 上告訴我們你的需求，並在 GitHub 上提交功能請求。如果你需要進一步的協助，也可以通過電子郵件聯繫我們。

對於開源 Logto 使用者，我們提供了一種易於擴展的連接器創建方法，允許你根據特定情境自訂你的連接器。我們始終歡迎提交 pull request 給 Logto，以便社群中的其他人也能從你的工作中受益。