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

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

提示:

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

開始使用

Aliyun 是亞洲主要的雲端服務提供商，提供多種雲端服務，包括 SMS（短訊服務）。Aliyun SMS 連接器是由 Logto 團隊提供的插件，用於調用 Aliyun 的 SMS 服務，藉此 Logto 的終端使用者可以透過簡訊驗證碼註冊並登入他們的 Logto 帳戶。

前往 Aliyun 網站並註冊你的 Aliyun 帳戶，如果你還沒有的話。

使用你的 Aliyun 帳戶登入 Aliyun 網站，並前往 SMS 服務控制台頁面。
點擊 SMS 服務頁面左上角的「免費開通」按鈕，開始配置流程。
閱讀並同意「短信服務開通條款」，然後點擊「開通服務」繼續。
現在你在 SMS 服務控制台頁面，根據你的使用情境，選擇側邊欄的「國內消息」或「國際 / 港澳台消息」按鈕。
根據指引新增簽名和模板，並提供審核所需的材料或資訊。
- 填寫簽名申請時，記得選擇「驗證碼」作為「適用場景」，申請模板審核時也選擇「驗證碼」作為「模板類型」，因為我們使用這些簽名和模板來發送驗證碼。目前，我們不支援發送除驗證碼相關的簡訊外的其他簡訊。
- 在模板內容中使用 {{code}} 作為數位驗證碼的佔位符。
提交你的 SMS 簽名和模板申請後，你需要等待其生效。此時，我們可以返回 SMS 服務控制台頁面並發送測試簡訊。如果你的簽名和模板已準備好使用，你可以直接嘗試；如果尚未生效，Aliyun 也提供測試模板。
- 在發送測試簡訊之前，你可能需要充值少量金額。
- 在發送測試簡訊之前，你可能還需要綁定測試手機號碼。更多詳情，請前往 SMS 服務控制台頁面側邊欄的「快速學習」標籤。

從 SMS 服務控制台頁面，將滑鼠懸停在右上角的頭像上，進入「AccessKey 管理」，然後點擊「創建 AccessKey」。完成安全驗證後，你將獲得一對「AccessKey ID」和「AccessKey Secret」。請妥善保管。
前往你剛才訪問的「國內消息」或「國際 / 港澳台消息」標籤，你可以輕鬆找到「簽名名稱」和「模板 CODE」。
- 如果你想使用僅供測試的簽名和模板，請改為前往「快速學習」標籤，你會在「簽名和模板（僅供測試）」下方找到它們。
填寫 Aliyun SMS 連接器設定：
- 使用你在步驟 1 中獲得的 access key 對填寫 accessKeyId 和 accessKeySecret 欄位。
- 使用步驟 2 中提到的「簽名名稱」填寫 signName 欄位。所有模板將共用此簽名名稱。
- 你可以為不同情境新增多個 SMS 連接器模板。以下是新增單一模板的範例：
  - 使用步驟 2 中的「模板 CODE」填寫 templateCode 欄位，以控制 SMS 內容。
  - 根據不同使用情境，將 usageType 欄位填寫為 Register、SignIn、ForgotPassword 或 Generic。（usageType 是 Logto 的屬性，用於識別適當的使用情境。）為了啟用完整的使用者流程，需要具備 Register、SignIn、ForgotPassword 和 Generic 的 usageType 模板。

你可以輸入一個電話號碼並點擊「發送」來檢查設定是否有效，然後再「儲存並完成」。

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