← Retour au blog

Selenium et Chrome : pourquoi --proxy-server ignore le login:mot de passe et comment le corriger

Nous examinons la raison pour laquelle Chrome n'accepte pas l'authentification proxy via le drapeau --proxy-server et proposons 4 méthodes fonctionnelles pour contourner la restriction dans Selenium.

📅14 novembre 2026

Si vous avez déjà essayé de lancer Chrome via Selenium avec un proxy de type --proxy-server=http://user:password@ip:port, vous avez probablement rencontré le problème où le navigateur s'ouvre soit sans proxy, soit affiche une fenêtre d'authentification système, qui bloque tout le script. Ce n'est pas un bug de votre code — c'est une limitation architecturale de Chromium que Selenium ne résout pas directement. Dans cet article, nous allons examiner pourquoi cela se produit et fournir 4 méthodes fonctionnelles pour transmettre le login et le mot de passe du proxy à Chrome sans saisie manuelle.

Pourquoi --proxy-server n'accepte pas user:pass

Le drapeau --proxy-server dans Chromium était initialement conçu uniquement pour spécifier le protocole, l'adresse IP et le port du serveur proxy. La syntaxe avec des identifiants de type user:password@host:port fonctionne dans curl, wget et de nombreux autres utilitaires, mais Chromium rejette simplement cette partie de l'URL lors de l'analyse du drapeau. C'est un comportement confirmé, décrit dans le bug tracker de Chromium depuis les versions 50, et au fil des ans, les développeurs n'ont toujours pas ajouté le support de l'authentification via la ligne de commande — pour des raisons de sécurité : le mot de passe dans les arguments du processus est visible via ps aux ou le gestionnaire de tâches, ce qui est considéré comme une fuite.

En fin de compte, Chrome se connecte honnêtement au serveur proxy, mais dès que celui-ci répond avec le code 407 Proxy Authentication Required, le navigateur affiche une fenêtre de dialogue native avec les champs «Nom d'utilisateur» et «Mot de passe». Selenium ne sait pas travailler avec les dialogues système de l'OS — il ne gère que l'arbre DOM de la page, donc il est impossible de fermer ou de remplir automatiquement cette fenêtre via l'API standard de WebDriver. Le script reste simplement bloqué en attendant que quelqu'un saisisse manuellement les données ou que le délai d'attente expire.

Il est important de comprendre : le problème concerne spécifiquement les proxies HTTP/HTTPS et SOCKS5 avec authentification par login et mot de passe. Si le proxy est protégé par une IP-whitelist (sans login), le dialogue d'authentification n'apparaît pas du tout, et le drapeau --proxy-server fonctionne normalement. C'est pourquoi pour le scraping et l'automatisation via proxies de data centers de nombreux développeurs choisissent initialement un tarif lié à l'IP plutôt qu'au mot de passe — cela élimine le problème à la source. Mais si vous avez un pool de proxies résidentiels rotatifs, la liaison par IP est souvent peu pratique, et il faut résoudre le problème par programmation.

Méthode 1 : extension Chrome avec authentification proxy

La méthode la plus fiable et durable consiste à générer une mini-extension Chrome (Manifest V2 ou V3) qui intercepte l'événement onAuthRequired et insère automatiquement le login et le mot de passe, contournant ainsi le dialogue système. L'extension est créée à la volée dans le code Python et connectée à Chrome via l'option add_extension.

import zipfile
from selenium import webdriver
from selenium.webdriver.chrome.options import Options

def create_proxy_extension(proxy_host, proxy_port, proxy_user, proxy_pass, plugin_path="proxy_auth.zip"):
    manifest_json = """
    {
      "version": "1.0.0",
      "manifest_version": 2,
      "name": "Chrome Proxy Auth",
      "permissions": [
        "proxy", "tabs", "unlimitedStorage", "storage",
        "<all_urls>", "webRequest", "webRequestBlocking"
      ],
      "background": {"scripts": ["background.js"]},
      "minimum_chrome_version":"22.0.0"
    }
    """

    background_js = f"""
    var config = {{
        mode: "fixed_servers",
        rules: {{
          singleProxy: {{
            scheme: "http",
            host: "{proxy_host}",
            port: parseInt({proxy_port})
          }},
          bypassList: ["localhost"]
        }}
      }};

    chrome.proxy.settings.set({{value: config, scope: "regular"}}, function() {{}});

    chrome.webRequest.onAuthRequired.addListener(
        function(details) {{
            return {{
                authCredentials: {{username: "{proxy_user}", password: "{proxy_pass}"}}
            }};
        }},
        {{urls: ["<all_urls>"]}},
        ["blocking"]
    );
    """

    with zipfile.ZipFile(plugin_path, "w") as zp:
        zp.writestr("manifest.json", manifest_json)
        zp.writestr("background.js", background_js)
    return plugin_path

plugin = create_proxy_extension("gate.example.com", 7000, "login123", "pass456")

options = Options()
options.add_extension(plugin)

driver = webdriver.Chrome(options=options)
driver.get("https://httpbin.org/ip")
print(driver.page_source)
driver.quit()

Cette méthode élimine complètement le dialogue d'authentification — Chrome insère automatiquement les identifiants à chaque requête 407. Inconvénient de l'approche : elle ne fonctionne qu'avec un navigateur visible (le mode headless des anciennes versions de Chrome avec des extensions peut être instable), et pour chaque nouveau proxy, il faut recréer l'archive zip. Pour un lancement massif de 20 à 50 profils avec différents proxies, cela se résout par la génération d'un plugin unique pour chaque profil dans une boucle.

Méthode 2 : Selenium Wire

Si vous ne voulez pas vous embêter avec la génération d'extensions, vous pouvez utiliser la bibliothèque selenium-wire — elle enveloppe le Selenium classique et ajoute sa propre couche proxy entre le navigateur et le serveur cible. Le login et le mot de passe sont transmis directement dans les options, sans dialogues ni extensions.

from seleniumwire import webdriver

proxy_options = {
    'proxy': {
        'http': 'http://login123:[email protected]:7000',
        'https': 'http://login123:[email protected]:7000',
        'no_proxy': 'localhost,127.0.0.1'
    }
}

driver = webdriver.Chrome(seleniumwire_options=proxy_options)
driver.get("https://httpbin.org/ip")
print(driver.page_source)
driver.quit()

Avantages : un minimum de code, support de SOCKS5, possibilité de changer de proxy à la volée entre les requêtes — c'est important si vous effectuez une rotation d'IP à chaque Nème page lors du scraping de Wildberries ou Ozon. Inconvénient : Selenium Wire ajoute son propre proxy MITM local, ce qui ralentit légèrement le chargement des pages et peut parfois entrer en conflit avec les sites utilisant un HSTS strict et le certificate pinning. Le projet n'a également pas été mis à jour aussi activement que le Selenium principal, donc la compatibilité avec les nouvelles versions de Chrome doit être vérifiée avant une utilisation en production.

Méthode 3 : CDP et Network.setBasicAuth (Selenium 4 BiDi)

À partir de Selenium 4, il est possible de travailler directement via le Chrome DevTools Protocol (CDP), ce qui permet d'intercepter les requêtes d'authentification sans bibliothèques tierces. Chrome prend en charge l'événement Fetch.authRequired, auquel on peut s'abonner via une session DevTools et répondre par programmation avec les identifiants.

from selenium import webdriver
from selenium.webdriver.chrome.options import Options

options = Options()
options.add_argument("--proxy-server=gate.example.com:7000")

driver = webdriver.Chrome(options=options)

# Activation de l'interception des événements réseau via CDP
driver.execute_cdp_cmd("Network.enable", {})
driver.execute_cdp_cmd("Network.setExtraHTTPHeaders", {"headers": {}})

# Dans Selenium 4.10+, une API d'authentification simplifiée est disponible
driver.execute_cdp_cmd("Fetch.enable", {
    "handleAuthRequests": True,
    "patterns": [{"urlPattern": "*"}]
})

# Exemple de gestionnaire (dans le code réel, un écouteur via la session websockets CDP est nécessaire)
# driver.on_auth_required(lambda: {"username": "login123", "password": "pass456"})

driver.get("https://httpbin.org/ip")
driver.quit()

En pratique, la mise en œuvre complète de ce gestionnaire nécessite de travailler avec une connexion WebSocket CDP de bas niveau (bibliothèque pycdp ou client BiDi intégré Selenium 4.10+), ce qui est déjà plus proche d'une tâche d'ingénierie que d'un script rapide. Cette méthode doit être choisie si vous construisez votre propre framework d'automatisation et souhaitez vous débarrasser de la dépendance à selenium-wire ou à la génération d'extensions. Pour la plupart des tâches d'automatisation SMM et de scraping de marketplaces, il est plus simple d'utiliser la méthode 1 ou 2.

Méthode 4 : proxy sans mot de passe via IP-whitelist

La solution la plus simple consiste à ne pas transmettre de login et de mot de passe à Chrome. De nombreux fournisseurs de proxy, y compris les proxies mobiles, prennent en charge l'authentification par adresse IP du serveur ou de la machine à partir de laquelle la requête est effectuée. Vous ajoutez votre IP externe à la whitelist dans le tableau de bord du fournisseur, et après cela, le drapeau --proxy-server=http://ip:port fonctionne sans aucun dialogue d'authentification — parce que le serveur proxy détermine lui-même que la requête provient d'une IP autorisée, et n'envoie pas le code 407.

from selenium import webdriver
from selenium.webdriver.chrome.options import Options

options = Options()
options.add_argument("--proxy-server=http://45.12.34.56:7000")  # proxy sans login, IP déjà dans la whitelist

driver = webdriver.Chrome(options=options)
driver.get("https://httpbin.org/ip")
print(driver.page_source)
driver.quit()

Cette approche est idéale pour les scénarios serveur — lorsque le script fonctionne sur un VPS dédié avec une IP externe permanente, et que vous l'ajoutez une fois à la whitelist. L'inconvénient apparaît lorsque l'IP de la machine change souvent (par exemple, internet domestique avec une IP dynamique ou des fonctions cloud avec des adresses éphémères) — alors la whitelist devra être mise à jour manuellement à chaque exécution, ce qui est peu pratique pour l'automatisation.

Comparaison des méthodes

Méthode Difficulté Mode Headless Quand utiliser
Extension Chrome Moyenne Limitée Fermes de comptes, automatisation visuelle
Selenium Wire Faible Oui Scraping, rotation rapide des proxies
CDP / Fetch.authRequired Élevée Oui Framework d'automatisation personnalisé
IP-whitelist sans mot de passe Minimale Oui Serveurs avec IP permanente

Liste de contrôle pour le débogage des problèmes d'authentification proxy

  • Vérifiez si le dialogue système apparaît lors du lancement sans mode headless — c'est un signe à 100 % d'un problème avec 407.
  • Assurez-vous que le port du proxy est correctement spécifié : HTTP et SOCKS5 fonctionnent souvent sur des ports différents chez un même fournisseur.
  • Si vous utilisez Selenium Wire, vérifiez la version — les anciennes versions peuvent entrer en conflit avec Chrome 115+.
  • Pour l'extension Chrome, assurez-vous que l'archive zip est reconstruite à chaque changement de login/mot de passe du proxy.
  • Lors de l'utilisation de l'authentification SOCKS5, gardez à l'esprit : le SOCKS5 natif dans Chrome ne prend pas en charge le login/mot de passe — un tunnel HTTP ou Selenium Wire est nécessaire.
  • Vérifiez les journaux du fournisseur de proxy : parfois, 407 se produit non pas à cause du code, mais en raison d'un tarif expiré ou d'un format de login incorrect (avec des suffixes de session/geo).

Conclusion

Le drapeau --proxy-server dans Chrome n'a jamais pris en charge la transmission directe du login et du mot de passe dans la chaîne — c'est une caractéristique de l'architecture de Chromium, et non une erreur de Selenium. Il existe quatre contournements fonctionnels : une extension maison avec interception onAuthRequired, la bibliothèque Selenium Wire, le travail de bas niveau via CDP, ou le refus complet du mot de passe au profit de l'IP-whitelist. Pour la plupart des tâches de scraping et d'automatisation des tests, Selenium Wire est suffisant ; pour un travail visuel avec des profils anti-détection, l'extension Chrome est plus pratique.

Si vous configurez l'automatisation sur des serveurs avec une IP permanente, envisagez des proxies de data centers avec liaison par whitelist — cela élimine complètement le problème d'authentification dans Chrome. Et pour les tâches nécessitant un changement de login et de mot de passe à la volée avec rotation géographique, les proxies résidentiels associés à Selenium Wire sont plus adaptés — vous obtenez ainsi à la fois flexibilité et stabilité de connexion sans fenêtres d'authentification.