以下の詳細は、2026 年 11 月 13 日時点の CAPTCHA サービス、Google、Apple のドキュメントに基づきます。最新の詳細はそれらを確認してください。
CAPTCHA のテストキー
これらは開発環境とステージングでのみ使い、環境変数から読み込んで、本番環境では本物のキーを使うようにしてください。
Cloudflare Turnstile には、結果ごとのサイトキーと、サーバー側で成功または失敗するシークレットキーがあります。
| サイトキー | 動作 |
|---|---|
1x00000000000000000000AA |
常に成功、表示あり |
2x00000000000000000000AB |
常にブロック、表示あり |
1x00000000000000000000BB |
常に成功、非表示 |
2x00000000000000000000BB |
常にブロック、非表示 |
3x00000000000000000000FF |
インタラクティブなチャレンジを強制 |
| シークレットキー | 動作 |
|---|---|
1x0000000000000000000000000000000AA |
常に成功 |
2x0000000000000000000000000000000AA |
常に失敗 |
3x0000000000000000000000000000000AA |
「token already spent」として失敗 |
テスト用サイトキーはトークン XXXX.DUMMY.TOKEN.XXXX を返しますが、本番のシークレットキーはこれを拒否します。
hCaptcha と Google reCAPTCHA v2 には、それぞれすべてのチェックを通すキーのペアが 1 組あります。
| キー | 内容 |
|---|---|
10000000-ffff-ffff-ffff-000000000001 |
hCaptcha サイトキー |
0x0000000000000000000000000000000000000000 |
hCaptcha シークレットキー |
6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI |
reCAPTCHA v2 サイトキー |
6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe |
reCAPTCHA v2 シークレットキー |
reCAPTCHA のテスト用ウィジェットには、テスト用である旨の警告が表示されます。reCAPTCHA v3 にはテストキーがないので、テスト環境用に別のキーを作成してください。
失敗もテストしましょう。Turnstile のブロック用キーを使い、何も言わずに失敗するのではなく、フォームが何が問題かを示し、もう一度試せるようになっているか確認してください。
Google サインイン
Google は自動化ソフトウェアで操作されているブラウザからのサインインをブロックすることがあるため、Google のサインインページに入力するエンドツーエンドテストは、良くても不安定です。自分の担当部分をテストしましょう。
- コールバック。 自分で管理するテストのトークンでサインインのコールバックを呼び出し(多くの認証ライブラリやプロバイダーには、テストモードやテストユーザーのセッションを発行する方法があります)、ユーザーが作成されてサインインしていることを確認します。
- アカウントのルール。 すでにパスワードのアカウントがあるアドレスで Google サインインした場合に、そのアカウントにリンクされるか、わかりやすいメッセージで拒否されるか、選んだとおりになることを確認します。
- 初回の画面。 新しい Google ユーザーがサインイン後に見る画面です。利用規約、ユーザー名、プロフィールの入力などです。
- 手動での確認を 1 回。 リリース前に、ステージングで自分で Google サインインを 1 回行います。
Sign in with Apple
Apple は Sign in with Apple のサンドボックスを公開していないので、同じ方法でテストします。コールバックとアカウントのルールは自動で、リリース前に本物の Apple Account で 1 回手動でサインインします。
意識してテストすべき点が 1 つあります。ユーザーはメールアドレスを非公開にできます。その場合、Apple はアプリに privaterelay.appleid.com のリレーアドレスを渡し、送信元のドメインやアドレスを Apple に登録している場合にのみ、メールが本人に届きます。アプリ自身の入力チェックでそのアドレスが受け付けられること、確認メールや領収書メールが登録済みの送信元から送られることを確認してください。
Proxy Mail QA の位置づけ
ほとんどのサインアップフォームでは、Google や Apple に加えてメールも選べます。その経路は、実行ごとに新しい Proxy Mail QA アドレスを使い、CAPTCHA のテストキーを通してテストし、確認メールが届いて正しく機能することを確認してください。