Como lidar com a autenticação de proxy no Selenium WebDriver

Os proxies HTTP entendem o tráfego da web e geralmente são configurados com valores HTTP e HTTPS separados. Os proxies SOCKS operam em um nível mais baixo e podem transportar diferentes tipos de tráfego TCP sem interpretar o protocolo de aplicação. O SOCKS5, além disso, oferece suporte à autenticação e geralmente é a versão preferida do SOCKS.

O navegador e o provedor de proxy devem suportar o mesmo método. Um endpoint válido não garante que o Selenium consiga preencher automaticamente um diálogo nativo de nome de usuário/senha.

Para um proxy que não requer autenticação interativa, o Selenium 4 pode atribuir um Proxy objetar a ChromeOptions. O atual Documentação oficial do Selenium browser-options demonstra essa abordagem baseada em capacidades.

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

Para SOCKS5, defina o endpoint e a versão do SOCKS:

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

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

Proxies autenticados exigem planejamento adicional. Incorporar credenciais em uma URL pode ser rejeitado por navegadores modernos e pode expor segredos. Prefira estas abordagens:

1. Lista de permissões de IP: Autorize o endereço IP público fixo do seu executor de CI ou nó do Selenium Grid para que nenhuma caixa de diálogo do navegador seja exibida.
2. Portal local: Instale um proxy de encaminhamento confiável na máquina de teste. O Selenium se conecta localmente sem credenciais, e o gateway autentica o servidor upstream.
3. Extensão de navegador controlada: Crie uma extensão interna do Chrome que configure o proxy e responda aos desafios de autenticação. Carregue-a somente a partir de um artefato de teste protegido.
4. Configuração em nível de grade: Configure a rede e os segredos no nó do Selenium em vez de distribuir credenciais para cada teste.

Leia as credenciais de um gerenciador de segredos ou de uma configuração de teste específica do ambiente. Nunca as inclua no Git, imprima-as na saída do console ou as inclua em capturas de tela. Após a inicialização, verifique o endereço IP de saída com um endpoint de teste aprovado antes de continuar o conjunto de testes.

O AutoIt pode automatizar diálogos do Windows localizando uma janela, digitando as credenciais e pressionando um botão. Essa era uma solução alternativa comum para o Selenium, pois o WebDriver não conseguia operar em janelas de autenticação pertencentes ao navegador.

O método é frágil: é exclusivo do Windows, requer uma área de trabalho interativa desbloqueada, depende dos títulos e do tempo das janelas e geralmente falha em contêineres sem interface gráfica ou agentes de CI remotos. Também pode revelar senhas por meio de scripts ou argumentos de processo.

Se um ambiente legado não deixar alternativa, compile o script AutoIt, armazene-o em um local controlado de artefatos de teste, recupere as credenciais com segurança em tempo de execução e aguarde o diálogo exato em vez de usar um tempo de espera fixo. Restrinja essa técnica a um executor isolado do Windows. Para suítes de teste de fácil manutenção, listas de permissão de IP, um gateway ou nós Grid configurados centralmente são opções mais seguras.

O Selenium consegue lidar com alertas JavaScript criados pelo código da página web:

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

No entanto, uma caixa de diálogo de autenticação de proxy normalmente aparece na interface do navegador, e não como um alerta em JavaScript. Portanto, driver.switchTo().alert() frequentemente joga NoAlertPresentException mesmo quando uma solicitação de credenciais é visível. A mesma limitação se aplica a muitas caixas de diálogo de autenticação básica HTTP.

Use a API de alertas somente após confirmar que o WebDriver reconhece o prompt. Caso contrário, remova o prompt por meio da configuração de rede ou use uma das abordagens de proxy autenticado descritas acima. Isso é mais estável do que coordenar as teclas pressionadas com uma janela que o Selenium não pode inspecionar.