メインコンテンツへスキップ
見出し画像

ブラウザ自動化の「ナビゲーション失敗」は失敗じゃなかった — CF Access認証リダイレクトで全員がハマる罠の正体と完全攻略法

    画像

    結論から言います。

    ブラウザ自動化ツールで「ナビゲーションが失敗した」と思ったら、それは失敗じゃありません。
    ただ「待ちが足りなかった」だけです。

    これ、めちゃくちゃ多くの人がハマるんですよ。
    僕もハマりました。

    Claude in Chrome、Google Antigravity、Playwright、Puppeteer——どんなブラウザ自動化ツールを使っていても、Cloudflare Access(以下CF Access)で保護されたURLにアクセスすると、高確率でこの罠にハマります。

    症状はこうです。

    自動化ツールでURLにナビゲートする。
    実行した。
    よし、タブの情報を確認しよう。

    ……あれ?
    URLが変わってない。
    タブタイトルも前のページのまま。

    「ナビゲーション失敗だ!」

    そう判断して、リトライを打つ。
    新しいタブを作る。
    JavaScriptで直接URLを書き換える。

    結果、タブが重複して、Detachedエラーが出て、状況はさらに悪化する。

    これ、全部やらなくてよかったんです。
    30秒待てば、勝手に読み込まれていたんです。

    今回の記事では、この「ブラウザ自動化×CF Access」の罠について、原因から対処法、影響を受けるツール、そして「二度とハマらないための設計思想」まで徹底的に解説します。

    ブラウザ自動化をやっている人、これから始める人、Cloudflare Workersを使っている人——全員に読んでほしい内容です。

    では、いきましょう!


    そもそもCloudflare Accessとは何か

    まず、CF Accessを知らない人のために基礎から説明します。

    CF Accessとは、Cloudflareが提供する「ゼロトラスト認証ゲートウェイ」です。
    簡単に言うと、Webアプリケーションの前に「認証の壁」を置くサービスです。

    たとえば、あなたがCloudflare Workers上にWebアプリを作ったとします。
    普通にデプロイすると、URLさえ知っていれば誰でもアクセスできてしまいますよね。

    でも、社内ツールや管理画面のように「特定のメンバーだけがアクセスできるようにしたい」場合がある。
    そこでCF Accessの出番です。

    CF Accessを設定すると、アプリのURLにアクセスした瞬間、自動的にCloudflareの認証ページにリダイレクトされます。
    ログインが完了すると、元のURLに戻ってくる。

    この仕組み自体は非常にシンプルで、手動ブラウザで使う分にはまったく問題ありません。
    ログインページが表示されて、認証して、戻ってくるだけ。

    ところが、この「リダイレクト」がブラウザ自動化ツールとの間に致命的な相性問題を引き起こすんです。


    「ナビゲーション失敗」の具体的な症状

    実際にどんな症状が起きるのか、もう少し詳しく見ていきましょう。

    症状1: タブタイトルが変わらない

    自動化ツールで`navigate`コマンドを実行して、CF Access保護されたURLにアクセスします。
    実行後、`tabs_context`(タブの情報を取得するコマンド)で確認すると、タブタイトルが前のページのままです。

    たとえば、Googleのトップページから社内ツールのURLに移動したとします。
    `tabs_context`を実行すると、タイトルが「Google」のまま。
    URLも`https://www.google.com`のまま。

    「あれ、ナビゲーション効いてない?」と思いますよね。

    症状2: URLが変わっていないように見える

    上の症状と同じですが、URLも旧ページのままです。
    実際にはバックグラウンドでリダイレクトが進行しているのですが、MCPや自動化ツールのAPI経由で取得できるタブ情報は、リダイレクト完了前の古い状態を返してしまうのです。

    これは「バグ」ではありません。
    リダイレクトチェーンの途中なので、まだ最終URLに到達していないだけです。

    症状3: リトライするとタブが増殖する

    ここからが地獄の始まりです。

    「ナビゲーション失敗した」と判断して、新しいタブを作って再度ナビゲートする。
    すると、元のタブでもリダイレクトが完了して、新しいタブでもリダイレクトが始まる。

    結果、同じページが2つのタブで開かれる。
    さらにリトライすると3つ、4つと増える。

    「なんでタブが増えてるんだ?」となって、さらに混乱する。

    症状4: JavaScriptで無理やりURLを書き換えるとDetachedエラー

    「`navigate`がダメなら、JavaScriptで直接`window.location.href`を書き換えよう」と考えるのは自然な発想です。
    でも、リダイレクトチェーン中のタブに対してJSを実行すると、ページコンテキストが「Detached」(切り離された)状態になってエラーになることがあります。

    これでますます「このツール、壊れてるんじゃないか?」と思ってしまう。


    「失敗」の正体: CF Accessの認証リダイレクトチェーン

    では、実際に何が起きているのか。
    技術的な裏側を解説します。

    CF Access保護されたURLにアクセスすると、以下の4段階のリダイレクトチェーンが発生します。

    ステップ1: ブラウザがターゲットURLにリクエスト

    あなたのブラウザ(自動化ツール)が`https://your-app.workers.dev/`にアクセスします。

    ステップ2: CF Accessが認証ページにリダイレクト

    Cloudflareのエッジサーバーがリクエストを受け取り、「CF Accessの保護対象だ」と判断します。
    そして、302リダイレクトで認証ページに飛ばします。

    リダイレクト先は、こんなURLです。

    `https://<your-team>.cloudflareaccess.com/cdn-cgi/access/login/<アプリID>?redirect_url=<元のURL>`

    ステップ3: 認証ページでCookie検証

    認証ページでは、以前のログインセッションのCookieがあるかどうかを確認します。

    • Cookieがある場合: 自動的に認証が通り、元のURLに302リダイレクト

    • Cookieがない場合: ログイン画面が表示される

    ここで重要なのは、Cookieがあっても検証に数秒〜十数秒かかることです。
    Cloudflareのエッジサーバーとの通信、JWT(認証トークン)の検証、アクセスポリシーの確認——これらが全部完了してからリダイレクトが発行されます。

    ステップ4: 元のURLに戻ってレスポンスが返る

    最終的に元のURLにリダイレクトされ、Cloudflare Workerがレスポンスを返します。

    このチェーン全体にかかる時間が、30秒〜数分です。

    手動ブラウザだと、この間ずっとスピナー(ぐるぐる回る読み込みアイコン)が表示されます。
    人間はそれを見て「あ、読み込み中だな」と理解して待ちます。

    でも、自動化ツールは違います。


    なぜ自動化ツールで特に問題になるのか

    ここが今回の話のキモです。

    人間の場合: 「スピナー」で判断できる

    手動でブラウザを操作している場合、タブに表示されるスピナーアイコンで「読み込み中だな」とわかります。
    人間は視覚的なフィードバックを元に、自然に「待つ」という行動をとります。

    URLバーを見ても、リダイレクト先のURL(cloudflareaccess.comの長いURL)が一瞬表示されるので、「あ、認証中だな」とわかる。

    つまり、人間は「状況を目で見て判断できる」のです。

    自動化ツールの場合: 「API」でしか判断できない

    一方、自動化ツールは`tabs_context`のようなAPIを通じてタブの情報を取得します。
    このAPIが返すのは、リダイレクトチェーンの途中段階での情報です。

    具体的に言うと、こうなります。

    1. `navigate`を実行する

    2. 500ミリ秒後に`tabs_context`を実行する

    3. タブのURLはまだ旧ページのURLが返る

    4. 「ナビゲーション失敗」と判断する

    これ、500ミリ秒では全然足りないんです。
    CF Accessのリダイレクトチェーンは30秒〜数分かかるのに、500ミリ秒で「失敗」と判断してしまっている。

    根本的な問題は、自動化ツールが「Webは非同期である」という事実を無視していることです。

    いや、より正確に言うと、自動化ツールのコードを書く人(AIエージェントを含む)が、「navigate = 即座にページが変わるもの」という誤った前提で実装していることが問題なのです。


    実際にハマった経緯 — デプロイ後の確認で起きた惨事

    ここで、僕が実際にハマったケースを紹介します。

    Cloudflare Workers上に管理画面(Control UI)をデプロイした後の話です。
    CF Accessで保護されたURLにClaude in Chrome(MCP経由のブラウザ操作)でアクセスしようとしました。

    手順はこうでした。

    1. Claude in Chromeの`navigate`ツールでControl UIのURLを指定

    2. 実行後すぐに`tabs_context`で確認

    3. URLが変わっていない

    4. 「失敗した」と判断してリトライ

    5. また`tabs_context`で確認——まだ変わっていない

    6. 新しいタブを作って再度ナビゲート

    7. さらに`tabs_context`で確認——新しいタブも旧URLのまま

    この時点で、僕は「Claude in Chromeに何かバグがあるのでは?」と疑い始めました。

    しかし、実際にはブラウザのタブバーを目視で確認すると、2つのタブがどちらも「読み込み中」のスピナーを回していたのです。

    ユーザー(この場合は僕自身)がブラウザの画面を確認して「ローディング続いてるタブが2つあるよ」と教えてくれたことで、ようやく気づきました。

    待っていれば、両方とも正常に読み込まれていたのです。

    つまり、最初の`navigate`は成功していた。
    2回目の`navigate`(リトライ)も成功していた。
    ただ、どちらもCF Accessのリダイレクトチェーン中だったので、`tabs_context`から見ると「URLが変わっていない」ように見えていただけ。

    約40秒後に、2つのタブが両方とも正しいURLに遷移していました。


    正しい対処法 — 「待つ」が正解

    ここまで読めば、対処法は明らかですよね。

    待てばいいんです。

    具体的な手順をまとめます。

    ステップ1: navigateを実行する

    まず、通常通り`navigate`ツールでCF Access保護されたURLを指定して実行します。
    ここまでは普通です。

    ステップ2: 30秒待つ

    ここが重要です。
    `navigate`実行後、何もせずに30秒間待ちます。

    「え、30秒も?」と思うかもしれませんが、CF Accessのリダイレクトチェーンはそのくらいかかるんです。
    むしろ30秒で済めば早い方です。

    ステップ3: tabs_contextで確認する

    30秒待ってから、`tabs_context`でタブの情報を確認します。

    URLが正しく変わっていれば成功。
    タブタイトルが期待通りに変わっていれば成功。

    ステップ4: まだ旧URLなら追加で30秒待つ

    もし30秒待ってもまだ旧URLのままなら、パニックにならずにもう30秒待ちます。

    ネットワーク状態やCloudflareのエッジサーバーの負荷によっては、60秒以上かかることもあります。
    でも、それは「失敗」ではなく「まだ途中」なだけです。

    ステップ5: 最大2分で完了する

    経験上、CF Accessのリダイレクトチェーンは最大でも2分程度で完了します。
    2分待っても変わらない場合は、本当に何か問題がある(ネットワーク断とか、CF Accessの設定ミスとか)可能性があるので、そこで初めてエラーとして扱いましょう。

    ステップ6: タブタイトルが変わったら成功

    タブタイトルが期待通りのものに変わっていれば、完全に成功です。
    そこからは通常通り、ページの操作を行ってください。


    絶対にやってはいけない4つの悪手

    逆に、「これだけは絶対にやるな」というアンチパターンもまとめます。

    悪手1: 「失敗」と判断してリトライする

    URLが変わっていないからといって、すぐにリトライしてはいけません。

    リトライすると、元のナビゲーション(まだリダイレクトチェーン中)と、新しいナビゲーションが並行して走ります。
    結果、同じページが複数タブで開かれて混乱します。

    悪手2: 新しいタブを作成して再ナビゲートする

    「元のタブがおかしいから、新しいタブで試そう」と考えるのは一見合理的ですが、やめてください。

    元のタブは「おかしい」のではなく、「まだ読み込み中」なだけです。
    新しいタブを作ると、同じリダイレクトチェーンがもう1つ走るだけです。

    結果、2つのタブが両方ともリダイレクトチェーン中になり、`tabs_context`から見るとどちらも「旧URLのまま」に見えて、さらに混乱します。

    悪手3: JavaScriptで直接URLを書き換える

    `window.location.href`をJSで直接書き換えるのは、リダイレクトチェーン中のタブに対しては特に危険です。

    ページのコンテキストがリダイレクト途中で不安定な状態にあるため、JSの実行自体が失敗したり、「Detached」エラーが発生したりします。

    やるなら、リダイレクトが完了してから(つまり十分に待ってから)にしてください。

    悪手4: 「ブラウザ自動化ツール固有の問題」と結論づける

    これが一番危険な悪手です。

    「Claude in Chromeがバグってる」「Antigravityの不具合だ」「MCPサーバーが壊れてる」——こう結論づけてしまうと、本当の原因(CF Accessのリダイレクト遅延)に永遠にたどり着けません。

    ツール固有の問題を疑う前に、まず「手動で同じ操作をしたらどうなるか?」を確認してください。
    手動でも同じようにスピナーが回って30秒かかるなら、それはツールの問題ではなく、Webサイト側の問題(この場合はCF Accessの仕様)です。


    影響を受けるツール一覧と個別対処法

    ここで、主要なブラウザ自動化ツールごとの影響と対処法をまとめます。

    Claude in Chrome (MCP)

    MCPサーバー経由でChromeを操作するツールです。

    影響: `navigate`実行後に`tabs_context`でタブ情報を取得すると、リダイレクトチェーン完了前の古い情報が返される。

    対処法:

    • `navigate`後に30〜60秒の`wait`を入れる

    • `tabs_context`で確認して、まだ旧URLなら追加で待つ

    • 「タブタイトルが変わったら成功」を判定条件にする

    Google Antigravity

    Googleが開発したブラウザ自動化フレームワークです。

    影響: Claude in Chromeと同様のリダイレクト遅延が発生します。

    対処法: 同上。30〜60秒の待機を入れる。

    Playwright / Puppeteer

    Microsoftが開発したPlaywrightと、Googleが開発したPuppeteer。
    どちらもNode.jsベースのブラウザ自動化ライブラリです。

    影響: `page.goto()`がデフォルトのタイムアウト(30秒)で失敗する可能性があります。
    CF Accessのリダイレクトチェーンが30秒以上かかるケースでは、`TimeoutError`がスローされます。

    対処法:

    • `page.goto(url, { timeout: 120000 })`のように、タイムアウトを120秒(2分)以上に設定する

    • `waitUntil: 'networkidle'`オプションを使って、ネットワークが安定するまで待つ

    • あるいは`page.waitForNavigation()`を明示的に使って、リダイレクト完了を待つ

    curl

    コマンドラインのHTTPクライアントです。

    影響: そもそもCF Accessを通過できません。
    curlは302リダイレクトに追従しますが、認証ページでJavaScriptの実行が必要なケースでは、curlでは認証を完了できないのです。

    対処法: curlではなく、ブラウザベースのツール(PlaywrightやPuppeteer)を使う。
    あるいは、CF AccessのService Token(APIトークン)を使って認証をバイパスする。


    CF Accessだけじゃない — 同じ問題が起きる認証サービス一覧

    この問題、CF Accessに限った話ではありません。

    認証リダイレクトチェーンを使うサービスは全て同じ問題を引き起こす可能性があります。
    主要なものをリストアップします。

    Auth0 / Okta

    エンタープライズ向けのSSO(シングルサインオン)サービスです。
    認証フローで複数回のリダイレクトが発生するため、自動化ツールから見ると「ナビゲーションが完了していない」ように見えます。

    リダイレクトの回数はCF Accessよりも多いこともあり、場合によっては60秒以上かかることもあります。

    AWS Cognito

    Amazonが提供する認証サービスです。
    Cognitoのホスティング認証ページを使っている場合、リダイレクトチェーンが発生します。

    特にCognitoのカスタムドメインを使っている場合、DNSの解決も加わるため遅くなりがちです。

    Google Cloud IAP (Identity-Aware Proxy)

    Google CloudのIAPを使っている場合も同様です。
    Googleアカウントの認証を挟むため、リダイレクトが複数回発生します。

    特にGoogleアカウントのMFA(多要素認証)が有効な場合、手動でも時間がかかるので、自動化ツールでのタイムアウトには注意が必要です。

    Azure AD (Entra ID) の条件付きアクセス

    MicrosoftのAzure ADを使った条件付きアクセスポリシーでも、同じ現象が起きます。
    特にデバイスコンプライアンスの確認が含まれる場合、リダイレクトチェーンが長くなります。

    共通の対処法

    いずれの認証サービスでも、対処法は同じです。

    十分に待つこと。

    具体的には、タイムアウトを120秒以上に設定すること。
    `navigate`後にすぐ`tabs_context`で確認しないこと。
    「URLが変わっていない = 失敗」と即断しないこと。


    「待つ」を設計に組み込む — 自動化ツールの正しいアーキテクチャ

    ここからが、この記事の本当のテーマです。

    「30秒待てばいい」というのは対処法としては正しいのですが、もっと根本的に、自動化ツールの設計思想を見直す必要があると思っています。

    問題の本質: 「同期的な思考」でWebを操作している

    多くの自動化スクリプトは、こんな構造になっています。

    1. navigateを実行
    2. URLを確認
    3. 変わっていなければエラー

    これは「同期的な思考」です。
    「命令を出したら即座に結果が返る」という前提で設計されている。

    でも、Webは非同期なんです。

    HTTPリクエストを送ってから、DNSの解決、TCPの接続、TLSのハンドシェイク、サーバーの処理、レスポンスの返却——この一連の流れにかかる時間は予測不可能です。

    さらにCF Accessのようなリダイレクトチェーンが入ると、1回のナビゲーションが複数回のHTTPリクエスト/レスポンスのやりとりになる。
    その全体にかかる時間は、ネットワーク状態やサーバー負荷によって大きく変動します。

    正しい設計: 「ポーリング」で状態を確認する

    自動化ツールの正しい設計は、こうです。

    1. navigateを実行
    2. 一定時間待つ
    3. 状態を確認(URLやタイトル)
    4. 期待する状態になっていなければ、さらに待つ
    5. 2〜4を繰り返す(タイムアウトまで)
    6. タイムアウトしたら初めてエラーとする

    これが「ポーリング」です。
    定期的に状態をチェックして、期待する状態になるまで待つ。

    この設計の良いところは、「何秒で完了するか」を事前に知っている必要がないことです。
    5秒で完了するかもしれないし、50秒かかるかもしれない。
    でも、ポーリングならどちらでも対応できる。

    具体的な実装パターン

    Playwrightを例に、具体的なコードパターンを紹介します。

    悪い実装:

    `page.goto(url)`を実行して、直後に`page.url()`で確認する。
    タイムアウトはデフォルトの30秒。

    良い実装:

    `page.goto(url, { timeout: 120000, waitUntil: 'networkidle' })`を実行する。
    タイムアウトを120秒に設定し、ネットワークが安定するまで待つ。
    さらに、`page.waitForSelector()`で期待するDOM要素が表示されるまで待つ。

    もっと良い実装:

    独自のポーリングロジックを組み、5秒ごとに`page.url()`をチェックする。
    期待するURLパターンにマッチしたら成功とする。
    120秒以上経過したらタイムアウトエラーとする。

    このように、「待つ」を設計の中に組み込むことで、CF Accessに限らずあらゆるリダイレクトや非同期処理に対応できるようになります。


    AIエージェントの場合 — 「判断の早さ」が仇になる

    ここまではブラウザ自動化全般の話でしたが、AIエージェントの場合、さらに別の問題があるので触れておきます。

    AIエージェント(Claude、GPTなど)がブラウザを操作する場合、エージェントは「効率的に行動する」ように設計されています。
    つまり、可能な限り早く結果を確認して、次のアクションに移ろうとするのです。

    これは普通の場面では良い特性です。
    でも、CF Accessのリダイレクトのように「ただ待てばいい」場面では、この特性が仇になります。

    エージェントは「待つ」ことが苦手なんです。

    人間なら「スピナーが回ってるから待つか」と判断できますが、エージェントはスピナーを「見る」ことができません。
    APIから返ってきたデータ(URL、タイトル)だけで判断するしかない。

    そして、データが期待通りでなければ、「何かアクションを取らなければ」と考えてしまう。
    その結果、リトライしたり、別のアプローチを試したり、最悪の場合「ツールが壊れている」と結論づけたりする。

    これを防ぐには、エージェントに「待つ」というアクションを明示的に教える必要があります。

    具体的には、プロンプトやシステムメッセージに以下のようなルールを含めるのが効果的です。

    • CF Access保護されたURLにナビゲートした後は、30秒以上待ってから状態を確認すること

    • URLが変わっていなくても、即座に「失敗」と判断しないこと

    • リトライする前に、少なくとも60秒は待つこと

    • 「ツールのバグ」と結論づける前に、手動で同じ操作をした場合の挙動を確認すること

    これだけで、AIエージェントがCF Accessの罠にハマる確率を大幅に下げることができます。


    「見えない待ち時間」はWebの本質

    ここで少し抽象的な話をさせてください。

    今回のCF Accessの問題は、「見えない待ち時間」がWebの本質的な特性であるということを改めて教えてくれました。

    普段、Webサイトを使っている時、僕らはあまり意識しませんよね。
    URLを入力してEnterを押せば、すぐにページが表示される。

    でも実際には、その裏で膨大な処理が走っています。

    DNS解決、TCP接続、TLSハンドシェイク、HTTPリクエスト、サーバーの処理、HTTPレスポンス、HTMLのパース、CSSの適用、JavaScriptの実行、画像のダウンロード——これらが全部完了して初めて、ページが「表示された」ことになる。

    CF Accessのリダイレクトは、この「裏側の処理」をさらに複雑にしているだけなんです。

    そして、ブラウザ自動化ツールは、この「裏側の処理」を直接扱わなければならない。
    人間はブラウザが見せてくれるUIフィードバック(スピナー、プログレスバー)を頼りに待てますが、自動化ツールにはそのフィードバックがない。

    だから、明示的に「待つ」ロジックを実装する必要がある。

    これは、Webを自動化するなら避けて通れない本質的な課題です。


    ブラウザ自動化の3つの教訓

    最後に、今回の経験から得た3つの教訓をまとめます。

    教訓1: ブラウザ自動化ツールの動作 = 手動ブラウザの動作

    自動化ツールで問題が起きたとき、まず疑うべきは「ツールのバグ」ではなく「Webサイト側の仕様」です。

    手動で同じURLにアクセスしてみてください。
    手動でも30秒かかるなら、自動化ツールでも30秒かかるのは当然。

    「ツール固有の問題」を疑うのは、手動では問題ないのに自動化だと問題が起きる場合だけにしましょう。

    教訓2: CF Access保護URLは遅い。30秒〜数分は正常

    「遅い」と「失敗」は違います。

    CF Accessのリダイレクトチェーンに30秒〜数分かかるのは、正常な動作です。
    異常ではありません。

    タイムアウトを十分長く取ること。
    30秒のデフォルトタイムアウトでは足りません。
    最低でも120秒は確保しましょう。

    教訓3: 「失敗」と判断する前に待つ

    自動化ツールは「即座に結果が出る」ことを期待しがちですが、Webは非同期です。

    「URLが変わっていない = 失敗」ではありません。
    「URLがまだ変わっていない = 途中」です。

    この違いを理解しているだけで、デバッグにかける時間が大幅に減ります。


    応用編: 自分のプロジェクトでCF Accessを使う場合のチェックリスト

    もしあなたがCloudflare WorkersでアプリケーションをデプロイしてCF Accessで保護している場合、以下のチェックリストを確認してください。

    デプロイ時のチェック

    • CF Accessのポリシーが正しく設定されているか

    • Service Tokenが発行されているか(API経由のアクセスが必要な場合)

    • 認証のバイパスルールが適切か(ヘルスチェック用のパスなど)

    自動化テスト時のチェック

    • ナビゲーションのタイムアウトが120秒以上に設定されているか

    • リトライロジックが「即座にリトライ」ではなく「十分に待ってからリトライ」になっているか

    • タブの状態確認が「ポーリング」形式になっているか

    AIエージェント開発時のチェック

    • エージェントのプロンプトに「CF Access保護URLは30秒以上待つ」ルールが含まれているか

    • エージェントが「ナビゲーション失敗」と即断しないようになっているか

    • エラーハンドリングで「タイムアウト」と「リダイレクト遅延」を区別できるようになっているか


    実践ガイド: Playwright × CF Accessの正しい実装

    ここからは、実際にPlaywrightでCF Access保護されたサイトにアクセスする場合の、正しい実装パターンを紹介します。

    基本パターン: タイムアウトを延長する

    最もシンプルな方法は、`page.goto()`のタイムアウトを延長することです。

    デフォルトは30秒(30000ミリ秒)ですが、CF Access保護されたURLにアクセスする場合は120秒(120000ミリ秒)以上に設定してください。

    さらに、`waitUntil`オプションを`'networkidle'`に設定すると、ネットワークの通信が落ち着くまで待ってくれるので、リダイレクトチェーンの完了を正しく検知できます。

    応用パターン: ポーリングで状態を確認する

    タイムアウトの延長だけでは心もとない場合、独自のポーリングロジックを組むのが最も確実です。

    手順はこうです。

    1. `page.goto()`をタイムアウト長めで実行する(120秒)

    2. ページの読み込み完了を待つ

    3. 5秒間隔で`page.url()`をチェックする

    4. 期待するURLパターンにマッチしたら成功

    5. 120秒経過してもマッチしなければエラー

    この方法の利点は、リダイレクト中の状態を細かく把握できることです。
    5秒ごとにURLを確認するので、「あ、今cloudflareaccess.comの認証ページにいるな」「あ、元のURLに戻ったな」という遷移が追跡できます。

    上級パターン: Service Tokenで認証をバイパスする

    テスト目的であれば、CF AccessのService Tokenを使って認証をバイパスする方法もあります。

    CF AccessのService Tokenは、APIリクエストに特定のヘッダーを付与することで認証を通過できるトークンです。

    Playwrightの場合、`page.setExtraHTTPHeaders()`を使ってリクエストヘッダーにService Tokenを付与できます。

    これにより、リダイレクトチェーン自体が発生しなくなるので、待ち時間の問題が完全に解消されます。

    ただし、Service Tokenはセキュリティ上のリスクがあるため、本番環境では使わないこと。
    テスト環境やCI/CDパイプラインでのみ使用してください。


    MCP経由のブラウザ操作で気をつけること

    MCPサーバー(Model Context Protocol)経由でブラウザを操作する場合、追加の注意点があります。

    MCP特有の問題: ツール実行のタイムアウト

    MCPでは、ツール(`navigate`、`tabs_context`など)の実行にタイムアウトが設定されています。
    このタイムアウトがCF Accessのリダイレクト時間より短いと、ツール実行自体が失敗します。

    MCPサーバー側のタイムアウト設定を十分に長くすることが重要です。

    MCP特有の問題: `wait`の実装

    MCPのブラウザ操作ツールには、`wait`(指定秒数待つ)ツールが用意されている場合があります。
    CF Access保護されたURLにナビゲートした後、この`wait`ツールを使って30秒以上待つのが確実です。

    ただし、`wait`ツールがない場合や、AIエージェントが`wait`の必要性を理解していない場合は、上述のようにプロンプトでルールを教える必要があります。


    なぜこの問題が「知られていない」のか

    ここまで読んで「こんな基本的なこと、もっと知られてるはずでは?」と思った方もいるかもしれません。

    実は、この問題が「知られていない」理由は明確です。

    理由1: 手動では問題にならない

    手動でブラウザを操作する限り、この問題は発生しません。
    スピナーが回っているのを見て待つだけなので、誰も「問題」だと認識しない。

    理由2: CF Accessの利用者がまだ少ない

    CF Access(Cloudflare Zero Trust)は、比較的新しいサービスです。
    大企業ではまだ導入途上だし、個人開発者でCF Accessを使っている人は少数派。

    ブラウザ自動化 × CF Accessという組み合わせ自体が、まだニッチなのです。

    理由3: 自動化ツールのドキュメントに書かれていない

    PlaywrightやPuppeteerのドキュメントには、「認証リダイレクトチェーンがある場合はタイムアウトを延長してください」とは書かれていません。

    これは「一般的なWebサイト」を前提としたドキュメントだからです。
    CF Accessのような特殊な認証ゲートウェイを通る場合の注意事項は、ユーザーが自分で発見するしかない。

    理由4: AIエージェントは「待つ」ことを学習していない

    AIエージェントの多くは、大量のWebスクレイピングやブラウザ操作のデータから学習しています。
    でも、その学習データには「CF Access保護されたサイトにアクセスする」ケースはほとんど含まれていない。

    だから、AIエージェントは「CF Accessのリダイレクトチェーンに30秒かかる」ことを知らないのです。
    知らないから、500ミリ秒で「失敗」と判断してしまう。


    これからブラウザ自動化を始める人へ

    この記事を読んでいるあなたが、これからブラウザ自動化を始めようとしているなら、1つだけ覚えておいてください。

    Webは非同期です。

    `navigate`を実行したら、すぐにページが変わるとは限りません。
    データベースにクエリを投げたら、すぐに結果が返るとは限りません。
    ボタンをクリックしたら、すぐにモーダルが表示されるとは限りません。

    全ての操作の後に「待つ」を入れること。
    全ての確認は「ポーリング」で行うこと。

    これだけで、ブラウザ自動化のトラブルの8割は防げます。

    残りの2割は、本当にツール固有のバグだったり、サイト側の問題だったりしますが、それはまた別の話。

    まずは「待つ」ことから始めましょう。


    実例で理解する「認証リダイレクトチェーン」のタイムライン

    ここで、実際に何が起きているのかをタイムライン形式で見てみましょう。
    数字で追いかけると、「なぜ30秒かかるのか」が腑に落ちると思います。

    タイムライン: CF Access保護されたURLへのアクセス

    0秒: ブラウザが`https://your-app.workers.dev/`にリクエストを送信

    0.1秒: Cloudflareのエッジサーバーがリクエストをインターセプト。
    CF Accessのポリシーを確認し、「認証が必要」と判断。

    0.3秒: 302リダイレクトのレスポンスを返す。
    リダイレクト先は`https://<team>.cloudflareaccess.com/cdn-cgi/access/login/<アプリID>`。

    0.5秒: ブラウザがリダイレクト先にリクエストを送信。
    この時点で、自動化ツールの`tabs_context`は旧URLを返す可能性が高い。
    ブラウザはまだリダイレクト先のレスポンスを受け取っていないから。

    1.0秒: Cloudflare Accessの認証ページが読み込まれる。
    JWTの検証処理が開始される。

    3.0秒〜15秒: JWT(JSON Web Token)の検証。
    以前のセッションCookieが存在するか確認。
    存在する場合はトークンの有効期限、アクセスポリシーとの照合を実行。
    Cloudflareのエッジネットワーク内で複数のサーバー間通信が発生。

    15秒〜25秒: 認証が完了し、元のURLへの302リダイレクトが発行される。
    ブラウザが元のURLにリクエストを送信。

    25秒〜30秒: Cloudflare Workerがリクエストを処理し、レスポンスを返す。
    ブラウザがHTMLをレンダリング開始。

    30秒〜35秒: ページの表示が完了。
    タブタイトルが更新される。
    `tabs_context`で正しいURLとタイトルが返るようになる。

    おわかりいただけたでしょうか。

    この30秒間、ブラウザは「何もしていない」わけではありません。
    ものすごく忙しく、裏側で認証とリダイレクトを処理しているのです。

    それなのに、自動化ツールが1秒後に「URLが変わっていない!失敗だ!」と判断してしまう。
    29秒分の処理がまだ残っているのに。


    「30秒待てば解決」は本当? — 実測データで検証

    「30秒待てば解決する」と言い続けてきましたが、「本当に30秒で済むの?」という疑問もあると思います。

    実際にかかった時間を、いくつかのケースで計測してみました。

    ケース1: 既にログイン済み(セッションCookieあり)

    初回アクセスではなく、以前にログインしてセッションCookieが残っている場合。

    計測結果: 15〜25秒

    セッションCookieの検証が主な処理なので、ログインページの表示は省略されます。
    それでも15秒以上はかかる。
    これはCookieの暗号化検証とポリシー照合に時間がかかるためです。

    ケース2: 初回アクセス(ログインが必要)

    セッションCookieがなく、実際にログインページでの認証が必要な場合。

    計測結果: 45秒〜2分

    ログインページの表示 → ユーザー認証 → Cookie発行 → リダイレクト、という流れになるので、当然もっと時間がかかります。

    自動化ツールの場合、ログインページの操作自体も自動化する必要があるので、さらに複雑になります。

    ケース3: ネットワーク状態が悪い

    Cloudflareのエッジサーバーとの通信が不安定な場合。

    計測結果: 30秒〜90秒

    ネットワーク遅延が加わるので、全体の処理時間が大幅に増加します。
    特に海外のエッジサーバーを経由する場合、往復遅延(RTT)が100ms以上になることもあり、リダイレクト1回あたりの時間が増えます。

    まとめ: タイムアウトは120秒が安全ライン

    計測結果を踏まえると、タイムアウトは120秒(2分)が安全なラインです。

    60秒だとケース2やケース3で足りない可能性がある。
    120秒あれば、ほぼ全てのケースをカバーできます。

    もし120秒待っても完了しない場合は、本当にネットワーク障害やCF Accessの設定ミスなど、何か問題が起きている可能性が高い。
    その時に初めて「エラー」として扱いましょう。


    デバッグのコツ — CF Access関連の問題を素早く特定する方法

    CF Accessが絡む問題をデバッグする時のコツもまとめておきます。

    コツ1: ブラウザのDevToolsでリダイレクトチェーンを確認する

    手動でブラウザのDevTools(開発者ツール)を開いて、Networkタブでリダイレクトの流れを確認するのが最も確実です。

    CF Access経由のアクセスでは、302リダイレクトが複数回発生するのがNetworkタブで確認できます。
    各リダイレクトにかかった時間も表示されるので、「どこで時間がかかっているのか」が一目瞭然です。

    コツ2: `cloudflareaccess.com`へのリダイレクトがあるかで判別する

    URLバーに一瞬`cloudflareaccess.com`のURLが表示されたら、それはCF Accessの認証リダイレクトです。
    自動化ツールのログにも、このURLが記録されている場合があります。

    もしリダイレクト先に`cloudflareaccess.com`が含まれていなければ、CF Accessの問題ではない可能性があります。
    別の原因を探りましょう。

    コツ3: CF Accessのイベントログを確認する

    Cloudflareのダッシュボードには、CF Accessのアクセスログがあります。
    ここで、認証の成否やかかった時間を確認できます。

    「認証は成功しているのにリダイレクトが遅い」場合と、「認証自体が失敗している」場合では対処法が異なるので、ログで切り分けましょう。

    コツ4: Service Tokenでバイパスして切り分ける

    「この問題はCF Accessが原因なのか、それとも別の問題か?」を切り分けたい場合、Service Tokenで一時的にCF Accessをバイパスしてみてください。

    バイパスした状態でナビゲーションが即座に成功するなら、原因はCF Accessの認証リダイレクトです。
    バイパスしても問題が再現するなら、別の原因を探る必要があります。


    よくある質問(FAQ)

    最後に、この問題に関してよくある質問をまとめます。

    Q: CF Accessを無効にすればいいのでは?

    A: セキュリティ上、それは推奨しません。
    CF Accessは重要な認証レイヤーです。
    「自動化が面倒だから認証を外す」のは、家の鍵が面倒だからドアを開けっぱなしにするのと同じです。

    正しいアプローチは、認証を維持したまま自動化の設計を改善することです。
    タイムアウトを延長する、ポーリングを実装する、Service Tokenを使う——これらの方法で、セキュリティを犠牲にせずに自動化できます。

    Q: リダイレクトが速くなる方法はないの?

    A: Cloudflare側の最適化に依存するため、ユーザー側でできることは限られます。

    ただし、以下の方法で多少の改善が見込めます。

    • CF Accessのアクセスポリシーをシンプルにする(条件が多いほど検証に時間がかかる)

    • セッションの有効期間を長くする(再認証の頻度を下げる)

    • Cloudflareのエッジロケーションに近いネットワークを使う(物理的な距離が短い方がRTTが小さい)

    Q: Seleniumでも同じ問題が起きますか?

    A: はい、起きます。

    Selenium、Playwright、Puppeteer、Cypress、TestCafe——ブラウザを操作する全ての自動化ツールで同じ問題が発生します。

    なぜなら、これはツールの問題ではなく、Webの認証フロー自体の特性だからです。
    どのツールを使っても、CF Accessの認証リダイレクトチェーンにかかる時間は変わりません。

    Q: ヘッドレスブラウザ(画面表示なし)でも同じですか?

    A: はい、同じです。

    ヘッドレスモードでもヘッドフル(画面表示あり)モードでも、HTTPの通信フローは同じです。
    リダイレクトチェーンの処理にかかる時間も変わりません。

    唯一の違いは、ヘッドフルモードならスピナーが見えるので「読み込み中だな」と人間が確認できること。
    ヘッドレスモードではそれができないので、ログやAPIでの状態確認がより重要になります。

    Q: CF Access以外で同じ問題に遭遇したことはありますか?

    A: あります。

    特にOAuth 2.0の認証フロー(Google、GitHub、Microsoftアカウントでのログイン)で同じ現象を経験しています。

    OAuth 2.0では、認可コード取得のためにプロバイダーのページにリダイレクトされ、認証後にコールバックURLにリダイレクトされます。
    このフロー全体に10秒〜30秒かかることは珍しくありません。

    対処法は同じで、十分に待つことです。


    CI/CDパイプラインでの落とし穴

    ローカル環境でブラウザ自動化を動かしている場合はまだマシです。
    問題が起きたら手動でブラウザを確認して、「あ、リダイレクト中か」と気づくことができます。

    しかし、CI/CDパイプライン(GitHub Actions、CircleCI、Jenkins等)でブラウザ自動化テストを実行している場合、この問題はもっと深刻になります。

    なぜCI/CDで深刻なのか

    CI/CDパイプラインでは、テストがヘッドレスモードで実行されます。
    画面を見ることができないので、「リダイレクト中なのか、本当に失敗なのか」を人間が判断できません。

    さらに、CI/CDには通常「タイムアウト」が設定されています。
    ジョブ全体のタイムアウトが10分とか15分に設定されている場合、1つのテストケースでCF Accessのリダイレクトに2分待っていると、テストスイート全体のタイムバジェットを圧迫します。

    10個のテストケースがそれぞれCF Access保護されたURLにアクセスするなら、それだけで20分。
    ジョブのタイムアウトを超えて、テストが全部失敗する——なんてことも起こり得ます。

    CI/CDでの推奨パターン

    CI/CD環境では、以下のパターンが推奨です。

    パターン1: Service Tokenでバイパスする

    CI/CD環境では、CF AccessのService Tokenを環境変数に設定して、認証をバイパスするのが最も確実です。
    リダイレクトチェーン自体が発生しないので、テストの実行時間が大幅に短縮されます。

    Service Tokenはシークレット(環境変数)として管理し、コードにハードコードしないこと。

    パターン2: テスト対象をCF Access外に切り出す

    そもそもテスト用のエンドポイントにCF Accessをかけない、という方法もあります。
    テスト用のステージング環境はCF Accessなしで公開し、本番環境だけCF Accessで保護する。

    ただし、「CF Access越しの動作を確認したい」場合はこの方法は使えません。

    パターン3: タイムアウトを十分に確保する

    Service Tokenが使えない場合、CI/CDのジョブタイムアウトとテストのタイムアウトの両方を十分に長く設定します。

    個別テストのタイムアウト: 180秒(3分)以上。
    ジョブ全体のタイムアウト: テストケース数 × 3分 + バッファ。

    これにより、CF Accessのリダイレクトにかかる時間をテストが正しく待つことができます。


    組織でブラウザ自動化をする時の「ルール化」の重要性

    個人開発なら、「CF Access保護URLは30秒待つ」と自分で覚えておけばいい。

    でも、組織やチームでブラウザ自動化を運用する場合、この知識を個人の記憶に依存するのは危険です。

    新しいメンバーが入るたびに同じ罠にハマる。
    「先月の新人がCF Accessの問題で3時間溶かした」みたいな話が繰り返し起きる。

    組織でやるべきこと

    1つ目は、テストの共通基盤にCF Access対策を組み込むこと。

    チームで使うブラウザ自動化のベースコードに、CF Access対応のヘルパー関数を用意しておきます。
    「CF Access保護されたURLにアクセスする場合はこの関数を使ってね」とドキュメントに書いておけば、個々のメンバーがタイムアウト設定を忘れることがなくなります。

    2つ目は、プロンプトテンプレートにCF Accessルールを含めること。

    AIエージェントにブラウザ操作をさせる場合、プロンプトやシステムメッセージに「CF Access保護URLでは30秒以上待つこと」というルールを含めます。
    これにより、エージェントが毎回同じ罠にハマるのを防げます。

    3つ目は、トラブルシューティングガイドを作ること。

    「ブラウザ自動化で問題が起きたときの確認手順」をドキュメント化しておきます。
    その中に「CF Access保護URLへのアクセスは30秒〜2分かかることがある。URLが変わらない場合は、まず待ってみること」と明記しておく。

    知識を個人の頭の中から出して、チームの資産にすること。
    これが、組織でのブラウザ自動化を安定させる鍵です。


    「RPGの宿屋」理論 — 焦って進まず、HPを回復してから

    ゲームで例えるなら、この問題は「RPGで宿屋に泊まらずにダンジョンに突っ込む」のと似ています。

    HPが減っている(まだリダイレクトチェーンが完了していない)のに、先に進もうとする(次のアクションを実行する)。
    結果、ボスに負ける(エラーが出る)。

    正解は、宿屋でHPを全回復してから(リダイレクトが完了してから)ダンジョンに入ること(次のアクションを実行すること)です。

    ゲームのセオリーと同じなんですよ。
    「焦って進む」より「準備を整えてから進む」方が、結果的に早くクリアできる。

    ブラウザ自動化も同じです。
    30秒待つのがもったいないと思うかもしれませんが、30秒待つだけで回避できるトラブルに2時間のデバッグ時間を使うのは、もっともったいない。


    自動化の本質は「人間が楽になること」

    最後の最後に、もう1つだけ伝えたいことがあります。

    自動化の本質は、人間が楽になることです。

    ブラウザ自動化は、手作業で行っていたWebブラウザの操作をプログラムに任せることで、人間の時間を節約する技術です。
    テスト、データ収集、定型業務の自動化——いろいろな使い方があります。

    でも、自動化の設計を間違えると、楽になるどころか、デバッグに追われて余計に大変になる。

    今回のCF Accessの問題は、まさにその典型です。

    「30秒待つ」というたった1行のコード(あるいはプロンプトの1文)を追加するだけで解決する問題に、何時間もデバッグに費やしてしまう。

    「待つ」を設計に組み込むだけで、自動化はもっと安定する。
    安定すれば、本当に人間が楽になる。

    この記事を読んだあなたは、もう大丈夫です。
    CF Accessのリダイレクトで慌てず、落ち着いて30秒待てるはずです。


    今回の学びのまとめ

    最後にもう一度、今回の学びを整理します。

    現象: ブラウザ自動化ツールでCF Access保護URLにアクセスすると「ナビゲーション失敗」に見える

    原因: CF Accessの認証リダイレクトチェーンに30秒〜数分かかる。自動化ツールはリダイレクトチェーン途中のタブ情報を取得してしまうため、「URLが変わっていない = 失敗」と誤判断する

    対処法: 30秒以上待ってからタブ情報を確認する。タイムアウトを120秒以上に設定する。リトライする前に十分に待つ

    設計の教訓: 「待つ」を自動化の設計に組み込む。全ての状態確認はポーリングで行う。「同期的な思考」でWebを操作しない

    影響範囲: CF Accessだけでなく、Auth0、Okta、AWS Cognito、Google Cloud IAP、Azure ADなど、認証リダイレクトチェーンを使う全てのサービスで同じ問題が起きる可能性がある


    最後に

    ブラウザ自動化って、本当に奥が深いんですよ。

    「URLを開いてボタンをクリックするだけでしょ?」と思うかもしれませんが、実際にはWebの非同期性、認証チェーン、DOM操作の不安定さ、ネットワークの遅延——あらゆる「見えない複雑さ」と戦わなければならない。

    今回のCF Accessの問題は、その「見えない複雑さ」の典型例です。

    でも、原理を理解してしまえば対処は簡単です。
    「待つ」だけ。

    この記事が、同じ罠にハマる人を1人でも減らせたら嬉しいです。

    では、また!

    #ブラウザ自動化 #CloudflareAccess #Playwright #Puppeteer #MCP #AIエージェント #Claude #トラブルシューティング #Web開発 #Cloudflare

     
     
    総セミナー参加者 172,867人突破!(8,320回開催) Codex・ClaudeCodeのAIエージェント専門のAIスクール #ユニコスクール 運営 🙋 スクール生 4,641人 📅 AI事業だけで月商1億達成! 🏢 ユニコスクール株式会社の累計売上40億突破!

    あなたへのおすすめ