使用 SMTP 設定電子郵件驗證
Logto 的官方 SMTP 連接器。
本指南假設你已對 Logto 連接器 (Connectors) 有基本了解。若不熟悉，請參閱 連接器 (Connectors) 指南以開始使用。
開始使用
SMTP（簡單郵件傳輸協議）是一種用於電子郵件傳輸的網際網路標準通信協議。郵件伺服器和其他訊息傳輸代理使用 SMTP 來發送和接收訊息。
設定 SMTP 連接器
SMTP 是一種傳輸協議，不專屬於某些特定的電子郵件服務提供商，而是可以與所有提供商一起使用。
我們現在提供一些指南，幫助你使用 SMTP 連接器來發送電子郵件，以下是一些提供商的示例：
- Gmail 是全球最受歡迎的電子郵件服務供應商。
- 阿里雲直接郵件 和 SendGrid 郵件。你可能對這兩個電子郵件服務提供商有所了解，因為 Logto 團隊提供了相應的連接器；你可能對它們有大致的了解。
我們希望你能透過以下示例了解其他電子郵件供應商的設置 🚀
設定 Gmail 使用
你可以在 Gmail 獲取一個新的 Gmail 帳戶，或者如果你已有帳戶，可以使用現有帳戶。
Gmail 官方文章 顯示如何確定所需屬性的值以透過 SMTP 連接器操作 Gmail。
與 SendGrid SMTP API 整合
首先，我們假設你已經有一個 SendGrid 帳戶。如果沒有，請在 SendGrid 網站創建一個新帳戶。
你可以在 "Integrating with the SMTP API" 找到逐步指南。
開發人員可以在 "Sender Management" 訪問 發件人 詳細信息。
配置阿里雲直接郵件帳戶
登入 阿里雲網站。如果你沒有帳戶，請註冊一個新帳戶。
按照 使用 SMTP 發送電子郵件指南 完成這些「任務」，以獲取所需的設置和信息。
你可以前往 SMTP 服務地址頁面 選擇合適的 SMTP 服務地址主機和端口號。
要檢查「發件人地址」，你可以在 DirectMail 控制台 的左側導航窗格中找到入口。你應該在這裡看到 發件人地址 和 SMTP 密碼。
為了簡化，前述案例中僅提供了一個範本範例。你應該為其他使用案例添加更多範本。
你應根據你的 Gmail、SendGrid 或阿里雲帳戶設置更改用 "<" 和 ">" 包裹的值，並選擇保留其他不含 "<" 和 ">" 的欄位。
在範本內容中添加 {{code}} 作為佔位符，以在發送電子郵件時顯示隨機驗證碼。
測試 SMTP 連接器
你可以輸入一個電子郵件地址並點擊「發送」，以查看設置是否能在「保存並完成」之前正常運作。
就是這樣。別忘了在 登入體驗中啟用連接器。
配置類型
| 名稱 | 類型 |
|---|---|
| host | string |
| port | string |
| fromEmail | string |
| templates | Template[] |
| 範本屬性 | 類型 | 枚舉值 |
|---|---|---|
| subject | string | N/A |
| content | string | N/A |
| usageType | enum string | 'Register' | 'SignIn' | 'ForgotPassword' | 'Generic' |
| contentType | enum string | 'text/plain' | 'text/html' |
用戶名和密碼驗證選項
| 名稱 | 類型 | 枚舉值 |
|---|---|---|
| user | string | N/A |
| pass | string | N/A |
| type | enum string (OPTIONAL) | 'login' |
你也可以配置 OAuth2 驗證選項 和其他高級配置。詳情請參閱這裡。
我們在文本框中提供了一個包含所有可配置參數的範例配置，以幫助你設置自己的配置。（你需對配置負責，某些值僅供演示用途，可能不適合你的使用情況。）