Selenium で許可された CAPTCHA QA を連携

対象：自分のアプリのテスト用フック

この例は管理下の HTML ページの明示的な setCaptchaResponseForTest フックを通じて Selenium を連携します。サーバー側 REST クライアントの応答を自分のテストアプリに渡す例です。第三者ページに汎用的に適用する仕組みでも、CAPTCHA トークンを検証する機能でもありません。

まずローカルページを確認

selenium-example.py、対応クライアント、test-fixture.html を同じディレクトリに保存してローカルサーバーを起動します。

python3 -m http.server 8000 --bind 127.0.0.1

別のターミナルで実行環境を準備し、ローカル用の値で動作確認します。

python3 -m pip install selenium
# In another terminal, from the downloaded examples directory:
FIXTURE_TOKEN='local-fixture-only' python3 selenium-example.py

テストはページのフックで非表示の応答を設定し、フォームを送信して submitted を確認します。ブラウザーとドライバーが実行環境に必要です。このページとフックはテスト環境だけで使用してください。

必要な場合のみ有料タスクに接続

FIXTURE_TOKEN を外し、python の設定に従って Key、固定の冪等キー、タスク JSON を設定します。権限のあるテストアプリの値に置き換え、TEST_PAGE_URL を設定します。対象には同じテスト用フックが必要です。Key は実行側に保持し、ページに渡しません。

このローカルページは Turnstile チャレンジではありません。アプリがサーバー側で Turnstile を検証する場合、その正規フローまたは公式テストキーで別途確認します。フロント側の送信成功はサーバー検証の成功を意味しません。

ブラウザー状態を一致させる

Cookie 型のテストではセッション一貫性ガイドに従い、ブラウザー環境の作成前に同じプロキシ/IP と返却された useragent を設定します。この例は Turnstile 型の応答用で、全 Cookie 形式には対応しません。Turnstile 項目と安全な照会も確認してください。