Come gestire l'autenticazione proxy in Selenium WebDriver

I proxy HTTP comprendono il traffico web e sono generalmente configurati con valori HTTP e HTTPS separati. I proxy SOCKS operano a un livello inferiore e possono trasportare diversi tipi di traffico TCP senza interpretare il protocollo applicativo. SOCKS5 supporta inoltre l'autenticazione ed è solitamente la versione SOCKS preferita.

Il browser e il provider proxy devono supportare lo stesso metodo. Un endpoint valido non garantisce che Selenium possa completare automaticamente una finestra di dialogo nativa per l'inserimento di nome utente e password.

Per un proxy che non richiede autenticazione interattiva, Selenium 4 può assegnare un Proxy obiettare a ChromeOptions. L'attuale Documentazione ufficiale di Selenium relativa alle opzioni del browser. dimostra questo approccio basato sulle capacità.

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

Per SOCKS5, impostare invece l'endpoint e la versione SOCKS:

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

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

I proxy autenticati richiedono una pianificazione più accurata. L'inserimento delle credenziali in un URL potrebbe essere rifiutato dai browser moderni e potrebbe esporre dati sensibili. Si consiglia di adottare i seguenti approcci:

1. Elenco IP consentiti: Autorizza l'indirizzo IP pubblico fisso del tuo runner CI o del nodo Selenium Grid in modo che non venga visualizzata alcuna finestra di dialogo del browser.
2. Gateway locale: Installa un proxy di inoltro affidabile sulla macchina di test. Selenium si connette localmente senza credenziali e il gateway si autentica a monte.
3. Estensione del browser controllata: Crea un'estensione interna di Chrome che configuri il proxy e risponda alle richieste di autenticazione. Caricala solo da un artefatto di test protetto.
4. Configurazione a livello di griglia: Configura la rete e le credenziali sul nodo Selenium anziché distribuirle a ogni singolo test.

Leggere le credenziali da un gestore di segreti o da una configurazione di test specifica per l'ambiente. Non inserirle mai in Git, non stamparle nell'output della console e non includerle negli screenshot. Dopo l'avvio, verificare l'indirizzo IP di uscita con un endpoint di test approvato prima di continuare la suite.

AutoIt è in grado di automatizzare le finestre di dialogo di Windows individuando la finestra, inserendo le credenziali e premendo un pulsante. In passato era una soluzione alternativa comune in Selenium, poiché WebDriver non era in grado di gestire le finestre di autenticazione di proprietà del browser.

Il metodo è fragile: funziona solo su Windows, richiede un desktop interattivo sbloccato, dipende dai titoli delle finestre e dalla tempistica, e di solito fallisce nei container senza interfaccia grafica o negli agenti CI remoti. Può anche rivelare le password tramite script o argomenti di processo.

Se un ambiente legacy non lascia alternative, compilare lo script AutoIt, memorizzarlo in una posizione controllata per gli artefatti di test, recuperare le credenziali in modo sicuro in fase di esecuzione e attendere la finestra di dialogo specifica anziché utilizzare un intervallo di attesa fisso. Limitare questa tecnica a un runner Windows isolato. Per suite gestibili, le soluzioni più sicure sono la whitelist IP, un gateway o nodi Grid configurati centralmente.

Selenium è in grado di gestire gli avvisi JavaScript creati dal codice della pagina web:

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

Tuttavia, una finestra di dialogo di autenticazione proxy è normalmente Chrome del browser, non un avviso JavaScript. Pertanto, driver.switchTo().alert() spesso lancia NoAlertPresentException anche quando viene visualizzata una richiesta di credenziali. La stessa limitazione si applica a molte finestre di dialogo di autenticazione HTTP di base.

Utilizza l'API di avviso solo dopo aver verificato che WebDriver riconosca il prompt. In caso contrario, rimuovi il prompt tramite la configurazione di rete oppure utilizza uno degli approcci con proxy autenticato descritti in precedenza. Questa soluzione è più stabile rispetto al coordinamento della pressione dei tasti con una finestra che Selenium non è in grado di ispezionare.