Email connectors
Email コネクターは、Logto とあなたのメール配信サービスを統合し、メールを通じて安全なユーザー認証 (Authentication) を可能にします。設定が完了すると、ユーザーの サインアップ、サインイン、パスワードリセット、アカウントリンク、メンバー招待、および 高リスク操作の検証 のために ワンタイムパスワード (OTPs) を送信できます。
あなたの Email コネクターを選択する
Logto は 3 種類の Email コネクターオプションを提供しています：
無料の Logto Email サービス (Cloud のみ)
この組み込みのメールサービスオプションは、テスト と 本番 の両方で迅速に開始するのに理想的です。サードパーティの統合が不要で、無料で信頼性のあるメール配信を提供します。事前にデザインされたメールテンプレートに対して基本的なブランディングをカスタマイズするだけです。
Logto Email サービスコネクターは、ロゴ、会社情報、送信者名を含むブランドカスタマイズ機能を提供します。
ただし、便利ではありますが、送信者のメールアドレス、ドメイン、特定のメール内容をカスタマイズすることはできないという制限があります。
Logto Email サービスの公式コネクター。
人気のあるメールプロバイダー
Logto のステップバイステップガイドを使用して、お好みのメールサービスプロバイダー (ESP) と接続します。
これらのオプションにより、メールテンプレート、送信者名などを完全にカスタマイズして、ブランドに最適なサービスを提供できます。
次のメールサービスプロバイダーに対して、すぐに使えるサポートを提供しています：
AWS 直接メールサービス用の公式 Logto コネクター。
Mailgun メールサービス用の公式 Logto コネクター。
SendGrid メールサービス用の公式 Logto コネクター。
Aliyun 直接メールサービス用の公式 Logto コネクター。
Postmark メールサービス用の Logto コネクター。
あなたの Email コネクターをカスタマイズする
上記のソリューションがニーズを満たさない場合、Simple Mail Transfer Protocol (SMTP) を使用して希望のメールサービスに接続することもできます。
SMTP 用の公式 Logto コネクター。
すでに独自のメールサービスを持っていて、SMTP 接続を使用する資格がない場合は、「HTTP Email コネクター」も提供しています。
メールを送信する必要がある場合、設定された endpoint に API コールを送信して、メールに依存する認証 (Authentication) フローを完了します。認証 (Authentication) フローのエラーを防ぐために、設定されたエンドポイントは WebHook を受信した後にメールを送信する通知を受け取ったことを Logto に知らせるために 200 応答を返す必要があります。この場合、独自のメールサービスを監視して、正常に配信されることを確認する必要があります。
HTTP メール用の公式 Logto コネクター。
標準のコネクターが特定の要件を満たさない場合は、お問い合わせください。OSS ユーザーの場合、要件が緊急であれば コネクターを実装する (OSS) ことができます。私たちは常に 貢献 を歓迎しています。あなたの努力は、同じニーズを持つ他のコミュニティメンバーを助けるかもしれません。
設定手順
以下の手順に従って Email コネクターを追加してください：
- Console > Connectors > Email and SMS connectors に移動します。
- 新しい Email コネクターを追加するには、「セットアップ」ボタンをクリックし、希望のメールプロバイダーを選択します。
- README ドキュメントを確認し、選択したプロバイダーの設定をステップバイステップで行います。
- 「保存して完了」をクリックして終了します。
Email コネクターを変更する
Email コネクターは 1 つしか追加できないことに気付くかもしれません。
すでに Email コネクターがある場合、「Email コネクターを変更する」しか選択できません。この操作をコンソールで行うと、保存されるとすぐに有効になるため、保存する前に設定をテストしてください。
サービスの安定性を確保するために、Cloud ユーザーは開発環境用に dev テナント を作成できます。開発環境で設定をテストした後、設定を 本番 に「移行」し、セットアップを保存します。
Email サインアップまたはサインインを有効にする
Email コネクターを正常に追加し、設定を完了したら、ビジネスニーズに応じて Email + 検証コードに依存するサインインおよびサインアップ設定を有効にできます。
- 移動先： Console > Sign-in experience > Sign-up and sign-in
- サインアップ方法を設定する：サインアップ識別子として「Email アドレス」または「Email アドレスまたは電話番号」を選択します。注意：サインアップ時に Email 認証 (Authentication) は現在必須です。
- サインイン方法を設定する：選択したサインアップ識別子は自動的にサインイン方法になります。追加のサインインオプションを追加するには「別のものを追加」をクリックします。
- 変更を保存してテストする： 「変更を保存」をクリックして新しいサインイン体験を実装します。機能をテストするために「ライブプレビュー」を使用することを忘れないでください。
設定はすぐに有効になるため、既存の Email コネクターを削除すると、エンドユーザーの通常のログインおよび登録プロセスに影響を与える可能性があります。
たとえば、サインイン識別子に「Email + 検証コード」の組み合わせが含まれている場合、既存の Email コネクターを削除すると、ユーザーが Email で検証コードを受け取ることができなくなり、サインインフローでエラーが発生します。
コネクターの操作時には、潜在的なリスクに注意してください。
よくある質問
Email 送信者名をカスタマイズするにはどうすればよいですか？
私たちはまだ多くのコネクターに取り組んでいます。さらにオプションが必要な場合は、Discord でニーズをお知らせいただき、GitHub で機能リクエストを提出してください。さらにサポートが必要な場合は、Email でお問い合わせいただくこともできます。
貢献者のために、特定のシナリオに基づいて 独自のコネクターをカスタマイズ できるように、拡張しやすいコネクター作成方法を提供しています。コミュニティの他の人々もあなたの作業から利益を得ることができるように、Logto にプルリクエストを提出することを常に歓迎しています。
Logto Email コネクターで Email リクエストの IP アドレスを制限するにはどうすればよいですか？
一つの解決策は、Logto HTTP Email コネクターを使用することです。
サーバー上に関連するメールサービスを呼び出す API エンドポイントを実装し、この API エンドポイントを Logto の HTTP Email コネクター を通じてトリガーします。この方法では、API エンドポイントの IP アドレスを完全に制御でき、メールサービスプロバイダーの設定で対応する IP アドレスをホワイトリストに追加できます。