使用 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 內容的方式。
  - 根據不同使用情境，使用 Register、SignIn、ForgotPassword 或 Generic 填寫 usageType 欄位。（usageType 是 Logto 的屬性，用於識別適當的使用情境。）為了啟用完整的使用者流程，Register、SignIn、ForgotPassword 和 Generic 的 usageType 模板是必需的。

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

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