「登録画面では検証成功なのに、確認メールが受信箱に届いた証拠がない」——この状態はAPIだけでは判定できません。
2026年10月23日時点の結論は、Chrome Email Verification APIは登録確認メールを完全には代替できない、です。今週はAPIの成功経路と従来メールのフォールバックを別々にテストしてください。
対象読者: 自社の登録・アカウント復旧にAPIを導入する開発者は、トークンで証明できる範囲を確認できます。
登録フローを受け入れテストするQA担当者は、APIとメールのテストを分ける基準を得られます。
導入可否を評価するプロダクトエンジニアは、適用条件と受信の証拠を照らし合わせられます。
まず分けるべき証拠は3種類です
Chrome Email Verification APIが扱うのは、条件を満たしたユーザーがメールアカウントを管理できることの確認です。メールを送信したこと、メールが受信側に受け入れられたこと、ユーザーが受信箱で読めたことは、それぞれ別の事実です。ChromeのAPI公式説明も、APIによる確認はメールの到達を証明しないとしています。
| 確認したいこと | 必要な証拠 | APIだけで判定できるか |
|---|---|---|
| ユーザーがメールアカウントを管理している | APIのトークンをサーバーで検証した結果 | 条件がそろえば確認できます |
| アプリが確認メールを送った | メール送信処理の結果や送信ログ | できません |
| メールを受信箱で確認できた | テスト用受信箱での実受信と、リンクまたはコードによる完了 | できません |
「メールアドレスを確認済み」にする条件も、アプリ側で決める必要があります。アカウントの管理権限が確認できた時点で登録を完了するのか、歓迎メールや通知メールも必ず送るのかを整理してください。後者なら、APIが成功してもメール送信と受信のテストは残ります。
Email Verification Tokenはサーバーで検証します
ブラウザーが返した値を受け取っただけでは、検証完了として扱えません。Chromeのサーバー実装ガイドを参照し、トークンの署名と宣言を検証します。メールアドレス、サイトのオリジン、フォームに結び付けたnonceが自社の期待値と一致することも確認します。
| サーバー側で見る項目 | 確認する理由 | テスト時の異常ケース |
|---|---|---|
| 署名とトークンの形式 | ブラウザーから受け取った値を無条件に信頼しないため | 値の改変、形式不正 |
| メールアドレスとオリジン | 別のアドレスやサイトの結果を流用させないため | 値の不一致 |
| nonceと有効期限 | 別のフォームで取得した値や期限切れの値を拒否するため | nonceの不一致、期限切れ |
| 使用済みトークンの扱い | 同じ検証結果の再利用を防ぐため | 同一値の再送 |
具体的な署名検証や宣言の扱いは、公開時点の公式ガイドと仕様に従って実装してください。WICGのAPI草案は仕様案であり、確立済みのWeb標準として扱うものではありません。APIの成功をアプリの登録完了と同一視せず、サーバーが検証した結果を登録状態に反映させます。
成功経路はブラウザーとアカウントの条件に左右されます
APIが動くかどうかは、利用者の操作だけでは決まりません。対象ブラウザー、メール提供元の参加状況、該当アカウントへのログイン、認証や許可の操作など、複数の条件が関係します。Chromeの公式ドキュメントとChrome Platform Statusへの案内で、公開時点の試験段階と適用範囲を確認してください。
| 条件 | テストで確認すること | 条件を満たさない場合 |
|---|---|---|
| 対象ブラウザーと試験状態 | 現在の公式資料に対象として記載されているか | API非対応の経路を確認します |
| メール提供元とアカウント | 対象アカウントで利用条件を満たすか | API成功を前提にしません |
| ログインとユーザー操作 | 必要な認証・許可を完了できるか | 中断後の画面と再試行方法を確認します |
| トークン取得とサーバー検証 | 有効な値が正しく検証されるか | 既存のメール確認へ切り替えます |
Origin Trialの状態、対象範囲、試験用トークンの期限は変わる可能性があります。2026年10月の案内を含む公式資料をリリース前にも見直し、プロトタイプの対応範囲を安定したクロスブラウザー対応と誤認しないでください。試験状態やプロトコルの更新は、IETFのメール検証プロトコル草案も含めて確認できますが、草案は確定仕様ではありません。
最終更新:2026年10月23日。 Chrome公式API文書、サーバー実装ガイド、Chromeの更新案内、WICGおよびIETFの草案を根拠に整理しています。試験段階と適用範囲は公開前に各公式ページで再確認してください。
登録メールの回退は受信まで別に検証します
登録メールの回退テストでは、APIが使えない場合だけでなく、トークン欠落やサーバー検証失敗でも、既存のメール確認へ正しく移れるかを見ます。Chromeの公式資料が示す回退動作を確認しつつ、自社アプリの実装でも同じ分岐になることを確かめてください。送信ログが成功していても、それだけでは受信箱で読めたとは言えません。
| シナリオ | 期待する結果 | 合格の確認材料 |
|---|---|---|
| 有効なトークンを受け取る | サーバー検証後、設計した登録状態になる | 検証結果と登録状態 |
| トークンがない、または取得できない | メール確認へ移る、または明確な代替手段を示す | 画面遷移と送信処理 |
| トークンの検証に失敗する | 登録を無条件で許可せず、回退または再試行へ進む | サーバーログと画面表示 |
| メール回退が起動する | メールを受け取り、リンクまたはコードで完了できる | テスト用受信箱と完了状態 |
QAでは、次の項目を自社のテスト環境または許可を得た環境で確認します。
- [ ] APIを利用できる条件と、対象ブラウザー・アカウントの試験条件を公式資料で確認する
- [ ] メールアドレス、オリジン、nonceを含む有効なトークンをサーバーで検証する
- [ ] トークンの欠落、改変、期限切れ、nonce不一致をそれぞれ拒否できることを確認する
- [ ] APIが利用できない場合に既存のメール確認へ回ることを確認する
- [ ] テスト用受信箱で本文を読み、リンクまたはコードから登録を完了する
- [ ] APIの検証結果、メール送信記録、実際の受信結果を別々に記録する
メールを確認する経路では、受信できた本文、リンクやコードの動作、登録状態の更新までをひと続きで確認します。テスト用アドレスを扱う際は、実在する利用者の個人情報を持ち込まない設計も必要です。テスト環境での合成アカウントやアドレスの扱いは、プライバシーに関するガイドも参考にできます。また、受信結果の見方はメール到達テストの案内で確認できます。
よくある確認事項
APIの成功は、確認メールが届いた証明になりますか?
いいえ。APIが示すのは、条件を満たしたユーザーがメールアカウントを管理できることです。送信処理の成功や受信箱への到達は別に確認してください。確認メールや通知メールを機能として提供する場合は、メール経路のテストを省略できません。
どのようなときに従来のメール確認へ回りますか?
対象ブラウザーやメール提供元が条件を満たさない場合、ユーザーが必要な認証操作を完了しない場合、トークンを取得できない場合などです。トークンの検証に失敗したときの動作はアプリ側でも明示し、画面表示と回退の両方をテストしてください。
Email Verification Tokenのサーバー検証はどうテストしますか?
公式のサーバー実装ガイドに沿って署名と宣言を検証し、アドレス、オリジン、nonce、有効期限が期待値に合うかを確認します。正常なトークンに加え、値の改変や欠落、不一致も試します。異常値で登録が許可されないことと、適切な代替経路へ進むことが確認ポイントです。
API導入後も受信箱を確認する必要がありますか?
必要です。APIはメールが実際に届いたことを示さず、従来の確認メールに回る経路も残ります。テスト用受信箱で本文を確認し、リンクまたはコードから登録が完了するまでを別の受け入れ条件にしてください。これにより認証経路とメール配送経路を切り分けられます。
自社の登録フローで従来メールへの回退を試すなら、テスト用アドレスで受信内容を確かめる方法も選択肢になります。ResendBoxの一時受信機能を使う場合も、実際に確認できるのはそのテストで受信したメールまでであり、Chrome Email Verification APIの対応範囲や本番環境の到達を保証するものではありません。利用前にResendBoxの日本語ページで現在の機能を確認し、APIの検証結果とメールの実受信を別々に記録してください。
よくある質問
Chrome Email Verification APIの成功は、確認メールが届いた証拠になりますか?
なりません。APIが示すのは、適用条件を満たしたユーザーがメールアカウントを管理できることです。アプリがメールを送信した事実や、受信サーバーが受け入れた事実、受信箱に表示された事実とは別です。メール通知も提供する登録フローなら、APIの結果とは分けて送信記録とテスト用受信箱を確認してください。
どんなときに従来のメール確認へ切り替わりますか?
ブラウザーやメール提供元がAPIの利用条件を満たさない場合、対象アカウントにログインしていない場合、ユーザーが認証や許可の操作を完了できない場合などは、APIの成功経路を前提にできません。トークンが取得できない、またはサーバー検証に失敗した場合も含め、Chromeの公式資料で公開時点の適用範囲とフォールバック動作を確認し、自社の登録画面で分岐を試してください。
Email Verification Tokenはサーバー側で何を確認すればよいですか?
ブラウザーから渡された値をそのまま登録許可に使わず、Chromeのサーバー実装ガイドに沿ってトークンの署名と宣言を検証します。メールアドレス、サイトのオリジン、フォームに対応するnonceの一致を確認し、有効期限や再利用も含めて受け入れ条件を設計してください。テストでは有効値だけでなく、欠落、改変、期限切れ、不一致の各ケースも試します。
APIを導入した後も受信箱で登録メールを確認する必要がありますか?
必要です。APIの成功はメールの送達確認ではなく、非対応環境などでは従来のメール確認が使われるためです。テスト環境ではメールの送信処理、受信箱での本文表示、リンクまたはコードによる登録完了を独立して確認します。これにより、APIの認証成功とメール経路の不具合を混同せずに切り分けられます。
関連記事
- 一時メールのカスタムアドレスとランダムアドレス、どう選ぶ?2026年初心者ガイド · 捨てメアド · 2026-10-22
- 一時メールは送信・返信できる?2026年に受受信範囲を確認 · 捨てメアド · 2026-10-22
- 使い捨てメールは安全?用途を見極めて、使うアドレスを決める · プライバシーの境界線 · 2026-08-17