跳至主要內容

使用 Aliyun Direct Mail 設定電子郵件驗證

Logto 的官方 Aliyun 連接器，用於直接郵件服務。

提示:

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

開始使用​

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

在 Aliyun DirectMail 控制台中設定電子郵件服務​

建立 Aliyun 帳戶​

前往 Aliyun 並建立你的 Aliyun 帳戶，如果你還沒有的話。

啟用並配置 Aliyun Direct Mail​

前往 DM 服務控制台頁面 並登入。點擊頁面左上角的「申請開通」按鈕啟用 Direct Mail 服務，並開始配置流程。

從 DM 管理控制台頁面 開始，你應該：

  1. 從側邊欄進入「發信域名」，按照指示新增「新建域名」。
  2. 分別自訂「發信地址」和「郵件標籤」。

完成設定後，有兩種不同的測試方式：

  • 前往 DirectMail 概覽頁面，在頁面底部找到「操作引導」，然後點擊「發送郵件」。你會找到所有不同類型的測試方法。
  • 按照側邊欄的路徑「發送郵件」->「郵件任務」來建立測試任務。

編寫連接器 JSON​

  1. 從 DM 管理控制台頁面，將滑鼠懸停在右上角的頭像上，進入「AccessKey 管理」，然後點擊「創建 AccessKey」。完成安全驗證後，你將獲得一對「AccessKey ID」和「AccessKey Secret」。請妥善保管。
  2. 從 DM 管理控制台頁面 進入你剛訪問過的「發信地址」或「郵件標籤」標籤，你可以輕鬆找到 Sender Address 或 Email Tag。
  3. 填寫 Aliyun DM 連接器設定：
    • 使用你在步驟 1 中獲得的 access key 對填寫 accessKeyId 和 accessKeySecret 欄位。
    • 使用在步驟 2 中找到的「發信地址」和「郵件標籤」填寫 accountName 和 fromAlias 欄位。所有模板將共享此簽名名稱。（fromAlias 是可選的，可以留空。）
    • 你可以為不同情況新增多個 DM 連接器模板。以下是新增單一模板的範例：
      • 填寫 subject 欄位，這將作為發送郵件的標題。
      • 使用任意字串類型內容填寫 content 欄位。不要忘記保留 {{code}} 佔位符以供隨機驗證碼使用。
      • 根據不同使用情況，填寫 usageType 欄位為 Register、SignIn、ForgotPassword 或 Generic。（usageType 是 Logto 的屬性，用於識別適當的使用情況。）為了啟用完整的使用者流程，Register、SignIn、ForgotPassword 和 Generic 的模板是必需的。

測試 Aliyun DM 連接器​

你可以輸入電子郵件地址並點擊「發送」以查看設定是否能在「儲存並完成」之前正常運作。

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

配置類型​

名稱類型
accessKeyIdstring
accessKeySecretstring
accountNamestring
fromAliasstring (可選)
templatesTemplate[]
模板屬性類型枚舉值
subjectstringN/A
contentstringN/A
usageTypeenum string'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'