認証コード · 2026年版ガイド

2026 Chrome Email Verification APIは登録確認メールを代替できる?開発者向けテスト方法

登録フローにChrome Email Verification APIを導入しても、登録確認メールのテストを省略できるとは限りません。APIが示すメールアカウントの管理権限と、メールの送信・到達を区別し、適用条件、トークン検証、フォールバック経路を確認する手順を紹介します。

「登録画面では検証成功なのに、確認メールが受信箱に届いた証拠がない」——この状態は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の認証成功とメール経路の不具合を混同せずに切り分けられます。

短期のメール受信を始める一時アドレスを生成し、同じページでメールを待って確認します。長期利用の転送エイリアスを作成本当のメールアドレスを隠しながら、継続的な受信と管理を維持できます。