承認、ログ、送信
SMTPでメールを送る
Supabase Auth、WordPressなどSMTP対応アプリをBangerに接続し、独自ドメインから送信してログで確認します。
このガイドの内容 8セクション
BangerのSMTPリレーは、Supabase Auth、Auth0、WordPress、フレームワークのメール機能など、SMTPでしか送れないアプリからの送信に対応します。Banger APIキーでログインし、独自ドメインから送信した各メールがログに表示されます。
始める前に
次の二つが必要です。
- プロダクトレーン。 Fromアドレスには準備済みプロダクトレーンのドメインかサブドメインを使います。ドメイン › レーンを追加でプロダクトを選び、表示されたDNSレコードを追加します。ドメインの追加を参照してください。チームのメールボックス用のメールレーンや一斉配信レーンではアプリのメールを送れないため、チームの受信トレイの評判に影響しません。
- 送信できるAPIキー。 APIキー › APIキーを作成でアプリ名(例: “Supabase Auth”)を付け、
mail:sendだけを選んでキーを作成を選びます。一度だけ表示されるので、すぐコピーしてください。
設定 › 開発者 › APIキーを管理からもAPIキーを開けます。
SMTP設定
APIキーページのSMTP欄に次の設定があり、ホストにはコピーボタンがあります。
| 設定 | 値 |
|---|---|
| ホスト | submit.bangermail.com |
| ポート | 465(TLS)または587(STARTTLS) |
| 上記がブロックされる場合のポート | 2465(TLS)または2587(STARTTLS) |
| ユーザー名 | banger(任意の値で可。キーがワークスペースを識別します) |
| パスワード | APIキー |
| 暗号化 | TLS 1.2以降。ログインはTLS開始後にだけ可能です。 |
| 認証 | PLAINまたはLOGIN |
アプリが”SSL”や”TLS”を求める場合は465、“STARTTLS”なら587を使います。
Supabase Authを接続する
- SupabaseのAuthentication › Emails › SMTP SettingsでカスタムSMTPを有効にします。
- Sender email:
noreply@app.example.comなどプロダクトレーンのアドレスです。 - 送信者名: プロダクト名です。Bangerは入力どおりに維持します。
- ホストは
submit.bangermail.com、ポートは465、ユーザー名はbanger、パスワードはAPIキーです。 - 保存し、Authentication › Usersから自分にマジックリンクを送ります。
ほかのアプリも同様に、SMTPやメール設定へ上記の値を貼り付けます。コード例はSMTP開発者向けドキュメントにあります。
動作を確認する
ログを開きます。各メールに発生元SMTPと配信状態が表示されます。拒否した試行も修正方法とともに記録されます。
Bangerが受理すると、アプリは250 2.0.0 Queued as …を受け取ります。
各メールの処理
- アプリの内容とFrom名を維持し、ドメインのDKIMキーで署名して送ります。
BccとReturn-Pathを除去し、Reply-ToがなければFromアドレスを指定して追加します。- 抑制された受信者をスキップし、残りに送ります。
- 同じメールの再試行は同じ送信として扱うため、タイムアウトで二重送信しません。
- 他の送信と同じく、プランの使用量に数えます。
各メールは最大10 MiB、受信者は最大50人です。
拒否された場合
拒否には理由と、ログの項目に対応する(ref …)が含まれます。4で始まるコードは一時的な問題なので、後で再試行できます。
| 応答 | 対処 |
|---|---|
535 5.7.8 | パスワードが有効なAPIキーではありません。取り消されておらず、mail:sendがあるか確認します。 |
421 4.7.0 | 同じ接続でログインに三度失敗したため切断されました。キーを修正して再試行します。 |
454 4.7.0 | ネットワークからのログイン失敗が多すぎます。キーを修正し、最大一時間待ちます。 |
550 5.7.1 | Fromドメインに準備済みプロダクトレーンがない、受信者が抑制されている、または送信が停止しています。不足条件は応答に示されます。到達率と送信停止を参照してください。 |
553 5.1.3 | 受信者アドレスが無効です。 |
552 5.3.4 | メールが10 MiBを超えています。 |
554 5.6.0 | Fromヘッダーが二つ、Fromに複数アドレスなど、形式が不正です。 |
451 4.7.0 | 送信枠か日次上限を使い切りました。次の期間や翌日に更新されるか、アップグレードですぐ利用できます。 |
451 4.3.0 | Bangerが現在受理できません。アプリで再試行します。 |
キーを保護する
- 各アプリに
mail:sendだけの専用キーを渡します。SMTPパスワードが漏れてもワークスペースを読めません。 - 交換時は新しいキーを作り、アプリを更新してから古いキーを取り消すします。古いキーのアプリは次回ログインで拒否されます。
- Bangerはキーのハッシュだけを保存し、拒否したログインをログに記録します。
AIで試す
メール送信だけができるAPIキーを作り、プロダクトレーンが準備できているか確認して、Supabaseに貼り付けるSMTP設定を教えてください。