Selenium WebDriverでプロキシ認証を処理する方法

HTTPプロキシはWebトラフィックを理解し、通常はHTTPとHTTPSの値を別々に設定します。SOCKSプロキシはより低レベルで動作し、アプリケーションプロトコルを解釈することなく、さまざまな種類のTCPトラフィックを伝送できます。SOCKS5はさらに認証をサポートしており、通常は推奨されるSOCKSバージョンです。

ブラウザとプロキシプロバイダは同じメソッドをサポートしている必要があります。有効なエンドポイントであっても、Seleniumがネイティブのユーザー名/パスワード入力ダイアログを自動的に完了できるとは限りません。

対話型認証を必要としないプロキシの場合、Selenium 4 は Proxy 反対する ChromeOptions。 現在 Seleniumの公式ブラウザオプションに関するドキュメント これは、能力に基づいたアプローチを実証するものです。

import org.openqa.selenium.Proxy;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.chrome.ChromeOptions;

Proxy proxy = new Proxy();
proxy.setHttpProxy("proxy.example.test:8080");
proxy.setSslProxy("proxy.example.test:8080");

ChromeOptions options = new ChromeOptions();
options.setProxy(proxy);

WebDriver driver = new ChromeDriver(options);
driver.get("https://example.com");

SOCKS5の場合は、代わりにSOCKSエンドポイントとバージョンを設定してください。

Proxy proxy = new Proxy();
proxy.setSocksProxy("proxy.example.test:1080");
proxy.setSocksVersion(5);

ChromeOptions options = new ChromeOptions();
options.setProxy(proxy);

認証付きプロキシには、より綿密な計画が必要です。URLに認証情報を埋め込むと、最新のブラウザで拒否される可能性があり、機密情報が漏洩する恐れがあります。以下の方法を推奨します。

1. IP 許可リスト: ブラウザダイアログが表示されないように、CIランナーまたはSelenium Gridノードの固定パブリックIPを認証してください。
2. ローカルゲートウェイ: テストマシン上に信頼できる転送プロキシを配置します。Seleniumは認証情報なしでローカルに接続し、ゲートウェイがアップストリームで認証を行います。
3. 制御されたブラウザ拡張機能: プロキシを設定し、認証の要求に応答する内部Chrome拡張機能を作成します。この拡張機能は、保護されたテストアーティファクトからのみロードします。
4. グリッドレベルの設定: 認証情報を各テストに配布するのではなく、Seleniumノード上でネットワークとシークレットを設定してください。

認証情報は、シークレットマネージャまたは環境固有のテスト構成から読み取ってください。決してGitにコミットしたり、コンソール出力に表示したり、スクリーンショットに含めたりしないでください。起動後、テストスイートを続行する前に、承認済みのテストエンドポイントで終了IPアドレスを確認してください。

AutoItは、ウィンドウの位置を特定し、認証情報を入力し、ボタンを押すことで、Windowsダイアログを自動化できます。かつては、WebDriverがブラウザ所有の認証ウィンドウを操作できなかったため、Seleniumの一般的な回避策として利用されていました。

この方法は脆弱です。Windows専用であり、ロック解除された対話型デスクトップが必要で、ウィンドウのタイトルとタイミングに依存し、ヘッドレスコンテナやリモートCIエージェントでは通常失敗します。また、スクリプトやプロセス引数を介してパスワードが漏洩する可能性もあります。

レガシー環境で他に選択肢がない場合は、AutoItスクリプトをコンパイルし、管理されたテスト成果物の場所に保存し、実行時に安全に認証情報を取得し、固定スリープを使用するのではなく、正確なダイアログが表示されるまで待機します。この手法は、隔離されたWindowsランナーに限定してください。保守性の高いスイートの場合は、IPアドレスの許可リスト、ゲートウェイ、または中央で構成されたGridノードの方が安全な選択肢です。

Seleniumは、ウェブページコードによって生成されたJavaScriptアラートを処理できます。

Alert alert = new WebDriverWait(driver, Duration.ofSeconds(10))
    .until(ExpectedConditions.alertIsPresent());
alert.accept();

しかし、プロキシ認証ダイアログは通常、ブラウザのクロームであり、JavaScriptのアラートではありません。したがって、 driver.switchTo().alert() よく投げる NoAlertPresentException 認証情報の入力画面が表示されている場合でも同様です。この制限は、多くのHTTP基本認証ダイアログにも適用されます。

WebDriverがプロンプトを認識することを確認してから、アラートAPIを使用してください。認識しない場合は、ネットワーク設定でプロンプトを削除するか、上記で説明した認証プロキシ方式のいずれかを使用してください。これは、Seleniumが検査できないウィンドウとキーストロークを連携させるよりも安定しています。