英語から自動翻訳されています。

英語で読む
Proxy Mail QA

開発環境だけで、使い捨てメールのブロックでテスト用アドレスを通す

使い捨てアドレスをブロックすると、本番アプリから偽のアカウントを締め出せます。しかし、自分たちのテストも締め出してしまいます。解決策はブロックを無効にすることではなく、開発環境とステージングにだけ存在する短い許可リストです。

更新日:

多くの登録フォームは、使い捨てメールで知られるドメインのアドレスを拒否します。この確認は、コード内のリスト、使い捨てドメインのリストのようなパッケージ、認証プロバイダーの設定、またはフォームが呼び出すメール確認サービスかもしれません。誰でもアドレスを作れるため、Proxy Mail QA のドメインがこうしたリストに載ることがあります。

ブロックを残し、テスト環境用の許可リストを追加する

本番ではブロックが役目を果たします。必要なのは、ブロックを通過するドメインの短いリストを、開発環境とステージングだけが設定する環境変数から読み込むことです。

// Read once at start-up. Unset in production, so the list is empty there.
const TEST_DOMAINS = (process.env.ALLOW_TEST_EMAIL_DOMAINS ?? '')
.split(',')
.map((domain) => domain.trim().toLowerCase())
.filter(Boolean);
export function isBlockedDomain(email: string, blocked: Set<string>): boolean {
const domain = email.split('@').pop()?.toLowerCase() ?? '';
if (TEST_DOMAINS.includes(domain)) return false;
return blocked.has(domain);
}

そのうえで、開発環境とステージングだけで:

ALLOW_TEST_EMAIL_DOMAINS=mailclub.dev,enable.li,valida.te.it
  • パターンではなくドメインを指定してください。 テストに使うドメインだけを正確に許可し、*.dev やドットを含むすべてのドメインを許可しないでください。
  • サーバーで読み込んでください。 ブラウザだけで動く確認は、フォームを直接送信する人には本番でもすり抜けられます。
  • 安全側に失敗させてください。 変数がなければリストは空になりブロックが適用されるので、設定の漏れで本番が開いてしまうことはありません。

ブロックが呼び出し先のサービスにある場合

メール確認サービスや認証プロバイダーには、通常独自の許可リストがあります。プロバイダーが環境を分けている場合は、開発環境またはステージングのプロジェクトだけに当社のドメインを追加してください。1 つの設定がすべての環境に適用される場合は、開発環境とステージングではサービスの確認をオフ、本番ではオンにするか、上記の環境変数にドメインがあるときは呼び出しを省略してください。

ユーザーに表示される内容を確認する

ついでに、ブロック自体もテストしてください。

  • ブロックされたドメインのアドレスは、一般的なエラーではなく、どうすればよいかを伝えるメッセージ(「仕事用または個人のメールアドレスを使ってください」)で拒否されること。
  • 拒否はアカウント作成の前に行われ、作りかけのユーザーが残らないこと。
    • タグ付きの実在の人のアドレス(name+news@example.org)は、それも拒否すると決めていない限り、通ること。

フォーム自体の検証については、珍しいが有効なアドレスで大文字、+ タグ、3 つの部分からなるドメインを扱っています。

次のサインアップテストで試してみてください

無料プラン、クレジットカード不要。アドレスを作成して、コードやリンクが届くのを確かめてください。

無料アカウントを作成アプリを開く

よくある質問

Proxy Mail QA のアドレスはどのドメインを使いますか?

mailclub.dev、enable.li、valida.te.it です。プロジェクトは Project settings でそのうち 1 つをメールドメインとして選び、Add account のドメイン選択で 1 つのアドレスだけ変更できます。

これらのドメインを本番でも許可すべきですか?

いいえ。Proxy Mail QA はアプリの開発環境、ステージング、プレビュー版のためのものです。許可リストを本番の設定に入れず、本番アプリが当社のドメインをほかの使い捨てドメインと同じように扱うようにしてください。

フォームがリストを確認する前にアドレスを拒否します。なぜですか?

一部のフォームはドメインではなくアドレスの形を確認し、+ タグ、ドットが複数あるドメイン、知らないドメインを拒否します。まず mailclub.dev のアドレスで試してください。それも拒否される場合、問題はブロックリストではなくフォームの検証です。

ブロックがまだ機能しているかテストできますか?

はい。許可リストを有効にしたまま、リストにない既知の使い捨てドメインのアドレスで登録してください。フォームは分かりやすいメッセージで拒否するはずです。見知らぬ人にメールが届かないよう、メールを受け取らないドメインを使ってください。

AI ツールでアプリを作りましたか?使ったツールを選んでください

このページについて質問がありますか?

質問はどの言語でもかまいません。ドキュメントからすぐに回答を得ることも、Proxy Mail QA チームに質問を送ることもできます。チームからの返信は英語です。