Wie man die Proxy-Authentifizierung in Selenium Webdriver handhabt

HTTP-Proxys verstehen Webverkehr und werden üblicherweise mit separaten HTTP- und HTTPS-Werten konfiguriert. SOCKS-Proxys arbeiten auf einer niedrigeren Ebene und können verschiedene Arten von TCP-Verkehr übertragen, ohne das Anwendungsprotokoll zu interpretieren. SOCKS5 unterstützt zusätzlich die Authentifizierung und ist in der Regel die bevorzugte SOCKS-Version.

Browser und Proxy-Anbieter müssen dieselbe Methode unterstützen. Ein gültiger Endpunkt garantiert nicht, dass Selenium einen nativen Benutzername/Passwort-Dialog automatisch ausfüllen kann.

Für einen Proxy, der keine interaktive Authentifizierung erfordert, kann Selenium 4 eine zuweisen. Proxy widersprechen ChromeOptions. Die jetzige offizielle Selenium-Browseroptionen-Dokumentation demonstriert diesen fähigkeitsbasierten Ansatz.

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");

Für SOCKS5 legen Sie stattdessen den SOCKS-Endpunkt und die Version fest:

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

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

Authentifizierte Proxys erfordern zusätzliche Planung. Das Einbetten von Anmeldeinformationen in eine URL kann von modernen Browsern abgelehnt werden und sensible Daten preisgeben. Folgende Vorgehensweisen sind vorzuziehen:

1. IP-Zulassungsliste: Autorisieren Sie die feste öffentliche IP-Adresse Ihres CI-Runners oder Selenium Grid-Knotens, damit kein Browserdialog angezeigt wird.
2. Lokales Gateway: Platzieren Sie einen vertrauenswürdigen Weiterleitungsproxy auf dem Testrechner. Selenium verbindet sich lokal ohne Anmeldeinformationen, und das Gateway authentifiziert sich vorgelagert.
3. Kontrollierte Browsererweiterung: Erstellen Sie eine interne Chrome-Erweiterung, die den Proxy konfiguriert und Authentifizierungsanfragen beantwortet. Laden Sie diese Erweiterung nur aus einem geschützten Testartefakt.
4. Konfiguration auf Netzebene: Konfigurieren Sie Netzwerk und Geheimnisse auf dem Selenium-Knoten, anstatt die Anmeldeinformationen an jeden Test zu verteilen.

Lesen Sie die Zugangsdaten aus einem Geheimnismanager oder einer umgebungsspezifischen Testkonfiguration. Speichern Sie diese niemals in Git, geben Sie sie nicht in der Konsole aus und fügen Sie sie nicht in Screenshots ein. Überprüfen Sie nach dem Start die Exit-IP-Adresse mit einem genehmigten Testendpunkt, bevor Sie die Testsuite fortsetzen.

AutoIt kann Windows-Dialoge automatisieren, indem es ein Fenster findet, Anmeldeinformationen eingibt und eine Schaltfläche drückt. Früher war dies eine gängige Selenium-Lösung, da WebDriver keine browserseitigen Authentifizierungsfenster bedienen konnte.

Die Methode ist fehleranfällig: Sie funktioniert nur unter Windows, erfordert einen entsperrten interaktiven Desktop, ist von Fenstertiteln und dem Timing abhängig und schlägt üblicherweise in Headless-Containern oder auf entfernten CI-Agenten fehl. Außerdem kann sie Passwörter über Skripte oder Prozessargumente offenlegen.

Wenn eine bestehende Umgebung keine Alternative zulässt, kompilieren Sie das AutoIt-Skript, speichern Sie es an einem kontrollierten Testort, rufen Sie die Anmeldeinformationen sicher zur Laufzeit ab und warten Sie auf den exakten Dialog, anstatt eine feste Wartezeit zu verwenden. Beschränken Sie diese Methode auf einen isolierten Windows-Runner. Für wartungsfreundliche Testumgebungen sind IP-Whitelisting, ein Gateway oder zentral konfigurierte Grid-Knoten sicherere Alternativen.

Selenium kann JavaScript-Warnmeldungen verarbeiten, die vom Webseitencode erzeugt werden:

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

Ein Dialog zur Proxy-Authentifizierung wird jedoch normalerweise vom Browser (Chrome) angezeigt und ist keine JavaScript-Warnung. Daher driver.switchTo().alert() wirft oft NoAlertPresentException selbst wenn eine Anmeldeaufforderung angezeigt wird. Dieselbe Einschränkung gilt für viele HTTP-Basisauthentifizierungsdialoge.

Verwenden Sie die Alert-API erst, nachdem Sie sichergestellt haben, dass WebDriver die Eingabeaufforderung erkennt. Falls dies nicht der Fall ist, entfernen Sie die Eingabeaufforderung über die Netzwerkkonfiguration oder verwenden Sie eine der oben beschriebenen Methoden mit authentifiziertem Proxy. Dies ist stabiler als die Koordination von Tastatureingaben mit einem Fenster, das Selenium nicht untersuchen kann.