SMTP を使用してメール認証を設定する
SMTP のための公式 Logto コネクター。
このガイドでは、Logto コネクターに関する基本的な知識を持っていることを前提としています。もし持っていない場合は、コネクターの設定 ガイドを参照して始めてください。
はじめに
SMTP (Simple Mail Transfer Protocol) は、電子メール送信のためのインターネット標準通信プロトコルです。メールサーバーやその他のメッセージ転送エージェントは、SMTP を使用してメッセージを送受信します。
SMTP コネクターを設定する
SMTP は特定のメールサービスプロバイダーに限定されない送信プロトコルであり、すべてのプロバイダーで動作します。
現在、以下のプロバイダーに従ってメールを送信するための SMTP コネクターの使用方法に関するガイドを提供しています:
- Gmail は世界で最も人気のあるメールサービスベンダーです。
- Aliyun direct mail と SendGrid mail。Logto チームが対応するコネクターを提供しているため、これらのメールサービスプロバイダーに慣れている方もいるかもしれません。一般的なアイデアを持っている可能性があります。
以下の例を参考にして、他のすべてのメールベンダーのセットアップを理解できることを願っています 🚀
Gmail の使用設定
Gmail で新しい Gmail アカウントを取得するか、既存のアカウントを使用できます。
Gmail 公式投稿 では、SMTP コネクターを介して Gmail を操作するために必要なプロパティの値を決定する方法が示されています。
SendGrid SMTP API との統合
最初に、すでに SendGrid アカウントを持っていると仮定します。持っていない場合は、SendGrid ウェブサイト で新しいアカウントを作成してください。
"SMTP API との統合" に関するステップバイステップガイドを見つけることができます。
開発者は "Sender Management" で sender の詳細にアクセスできます。
Aliyun direct mail アカウントの設定
Aliyun ウェブサイト にサインインします。アカウントを持っていない場合は、新しいアカウントを登録してください。
SMTP を使用してメールを送信するガイド に従い、必要な設定と情報を取得するための「タスク」を完了してください。
SMTP サービスアドレスページ にアクセスして、適切な SMTP サービスアドレスホストとポート番号を選択できます。
「送信者アドレス」を確認するには、DirectMail コンソール の左側のナビゲーションペインにある入口を見つけることができます。ここで Sender address
と SMTP Password
を確認することができます。
ℹ️ 注意
前述のケースでは、シンプルさを保つために 1 つのサンプルテンプレートのみが提供されています。他のユースケースのために、より多くのテンプレートを追加する必要があります。 Gmail、SendGrid または Aliyun アカウント設定に応じて "<" と ">" で囲まれた値を変更し、"<" と ">" のない他のフィールドを保持することを選択してください。 テンプレートのコンテンツに
{{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 認証オプション やその他の高度な設定も構成できます。詳細は こちら を参照してください。
テキストボックス内にすべての設定可能なパラメータを含む設定例を示しました。独自の設定を行う際に役立ててください。(設定はあなたの責任で行ってください。一部の値はデモンストレーション目的であり、あなたのユースケースに適合しない場合があります。)