跳至主要內容

電子郵件連接器

電子郵件連接器將你的電子郵件傳送服務與 Logto 整合，以透過電子郵件啟用安全的使用者驗證。一旦配置完成，你可以發送 一次性密碼 (OTPs) 用於使用者的 註冊、登入、密碼重設、帳戶連結、成員邀請 和 高風險操作驗證。

選擇你的電子郵件連接器​

Logto 提供三種類型的電子郵件連接器選項：

免費 Logto 電子郵件服務（僅限 Cloud）​

這個內建的電子郵件服務選項非常適合快速開始進行 測試 和 生產。它消除了對第三方整合的需求，並提供免費且可靠的電子郵件傳送。只需為預設的電子郵件模板自訂基本品牌。

Logto 電子郵件服務連接器現在提供品牌自訂功能，包括標誌、公司資訊和發件人名稱。

然而，儘管方便，但有一些限制需要注意——你無法自訂發件人的電子郵件地址、網域或特定的電子郵件內容。

使用 Logto 的逐步指南連接到你偏好的電子郵件服務提供商 (ESP)。

這些選項允許你完全自訂電子郵件模板、發件人名稱等，以最佳方式服務於你的品牌。

我們提供對以下電子郵件服務提供商的開箱即用支援：

自訂你的電子郵件連接器​

如果上述解決方案都不符合你的需求，你也可以選擇使用簡單郵件傳輸協定 (SMTP) 連接到你想要的電子郵件服務。

如果你已經擁有自己的電子郵件服務且不適合使用 SMTP 連接，我們也提供「HTTP 電子郵件連接器」。

當需要發送電子郵件時，它會向配置的 endpoint 發送 API 呼叫以完成依賴電子郵件的驗證流程。請注意，為防止驗證流程錯誤，配置的 endpoint 在接收到 WebHook 後需要返回 200 回應，以通知 Logto 已收到發送電子郵件的通知。在這種情況下，你需要監控自己的電子郵件服務以確保成功傳送。

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

配置步驟​

按照以下步驟新增電子郵件連接器：

  1. 前往 Console > Connectors > Email and SMS connectors 。
  2. 若要新增電子郵件連接器，點擊「Set up」按鈕並選擇你想要的電子郵件提供商。
  3. 查看 README 文件並逐步配置你選擇的提供商。
  4. 點擊「Save and Done」完成。

更改電子郵件連接器​

你可能會注意到只能新增一個電子郵件連接器。

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

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

啟用電子郵件註冊或登入​

一旦你成功新增電子郵件連接器並完成配置，你可以根據業務需求啟用依賴電子郵件 + 驗證碼的登入和註冊配置。

  1. 前往： Console > Sign-in experience > Sign-up and sign-in
  2. 設置註冊方法：選擇「電子郵件地址」或「電子郵件地址或電話號碼」作為註冊識別符。注意：目前註冊時電子郵件驗證是必須的。
  3. 設置登入方法：選擇的註冊識別符會自動成為登入方法。點擊「Add another」以獲得其他登入選項。
  4. 儲存變更並測試： 點擊「Save changes」以實施新的登入體驗。記得使用「即時預覽」來測試功能。
注意:

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

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

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

常見問題​

如何自訂電子郵件發件人名稱？​

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

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

如何在 Logto 電子郵件連接器中限制電子郵件請求的 IP 地址？​

一種解決方法是使用 Logto HTTP 電子郵件連接器。

在你的伺服器上實作一個 API endpoint，調用相關的電子郵件服務，並通過 Logto HTTP 電子郵件連接器 觸發此 API endpoint。這樣，你將能夠完全控制 API endpoint 的 IP 地址，並可以將相應的 IP 地址添加到電子郵件服務提供商配置中的白名單中。