Comment contourner l’inspection SSL d’un proxy d’entreprise et d’une SWG sur Mac

Pourquoi désactiver les Proxys des Réglages Système macOS ou utiliser networksetup échoue face aux SWG transparentes, et comment contourner par domaine ou corriger la CA CLI.

SWG bar · Mis à jour

Si désactiver les interrupteurs de proxy Wi-Fi dans Réglages Système → Réseau → Proxys — ou ajouter des domaines avec networksetup -setproxybypassdomains — laisse malgré tout votre Mac soumis à l’inspection SSL du proxy d’entreprise, votre appareil utilise un agent transparent de passerelle web sécurisée (SWG) (NetworkExtension ou tunnel utun) plutôt qu’un simple proxy HTTP explicite. Pour contourner l’inspection SWG pour un nom d’hôte précis sur un Mac autorisé, ouvrez SWG bar → Domaines, sélectionnez le nom d’hôte et activez Contourner la SWG (ou exécutez swgbar bypass enable <domain>).

La plupart des tutoriels sur les proxys macOS confondent deux architectures d’entreprise totalement différentes : les anciens proxys explicites / fichiers PAC et les agents SWG transparents modernes (comme Cisco Umbrella / Cisco Secure Client, Broadcom Cloud SWG, Zscaler, Netskope ou Cloudflare Gateway). Savoir laquelle votre Mac utilise explique immédiatement pourquoi les réglages proxy classiques ne font rien — et quelle solution fonctionne réellement.

1. Vérifier si votre Mac utilise un proxy explicite ou une SWG transparente

Effectuez deux vérifications rapides pour voir comment le trafic est acheminé sur macOS :

  1. Inspecter les réglages explicites de proxy système :
scutil --proxy

Recherchez HTTPEnable : 1, HTTPSEnable : 1 ou ProxyAutoConfigURLString (une URL .pac). 2. Inspecter l’interception réelle des certificats HTTPS : ouvrez SWG bar → Vue d’ensemble (ou exécutez swgbar overview / swgbar domains list --status confirmed).

  • Si scutil --proxy est vide, alors que SWG bar signale un Taux d’inspection des domaines > 0% (avec des domaines Confirmé ou Suspecté et des Certificats d’interception (MITM)), votre Mac est derrière un agent SWG transparent (NetworkExtension / utun) qui capture les paquets sous les réglages de proxy système de macOS.
  • Si scutil --proxy liste un proxy ou fichier PAC d’entreprise et que SWG bar affiche une CA racine MITM d’entreprise, le trafic passe par un proxy explicite/PAC qui effectue l’interception.

2. Proxy explicite vs proxy SWG transparent sur macOS

Architecture Où macOS intercepte le trafic Réglages Système → Proxys / networksetup le contourne-t-il ? Ce qui fonctionne sur un Mac autorisé
Proxy HTTP/HTTPS explicite ou PAC (non géré) Champs proxy de System Configuration macOS Oui, s’il n’est pas verrouillé par MDM (Ignorer les réglages proxy pour ces hôtes et domaines) Liste d’exceptions proxy macOS ou vérification du routage par domaine
Proxy explicite verrouillé par MDM ou SWG transparente (NetworkExtension / utun) Filtre socket et IP noyau / NetworkExtension sous les réglages proxy du navigateur Non — les réglages sont verrouillés, écrasés ou totalement ignorés par le tunnel SWG Contournement IPv4 physique Matériel par domaine via SWG bar (Comment contourner une SWG sur Mac), exclusions passerelle IT (External Domains / Do Not Decrypt) ou configuration d’un bundle CA pour CLI

3. Contourner l’inspection SSL du proxy SWG pour un domaine précis sur macOS

Lorsqu’une application web, un point de terminaison API ou un client bureau avec certificate pinning échoue derrière un proxy SWG d’entreprise sur un réseau que vous administrez ou êtes autorisé à configurer :

  1. Installez et ouvrez SWG bar (macOS 14+ sur puce Apple, essai gratuit de 14 jours d’utilisation) et reproduisez la requête afin que le nom d’hôte exact apparaisse dans Domaines.
  2. Ouvrez les détails du nom d’hôte et cliquez sur Activer le contournement pour ce domaine dans la ligne Contourner la SWG — ou exécutez :
swgbar bypass enable <domain>
swgbar bypass status
  1. Attendez l’état Contournement actif, puis rechargez la page web ou redémarrez le client Terminal/bureau afin que les sockets keep-alive existants se rouvrent via l’interface physique IPv4 Matériel de votre Mac (en0 / en7).
  2. Vérifiez avec swgbar probe <domain> que la chaîne de certificats publique du serveur d’origine est présentée proprement. Notez que si une application impose son propre réglage de proxy explicite (par exemple HTTP_PROXY / HTTPS_PROXY dans ~/.zshrc, ~/.npmrc ou ~/.gitconfig), supprimez ces variables de proxy pour cet hôte afin que l’application ne renvoie pas le trafic vers le port du proxy explicite.

4. Lorsque vous ne pouvez pas contourner le proxy : exclusions IT et bundles CA CLI

Si le pare-feu de votre entreprise bloque tout trafic IPv4 sortant direct ne transitant pas par le proxy SWG (périmètre fail-closed) :

  • Désactivez le contournement par domaine (swgbar bypass disable <domain>) afin que le nom d’hôte revienne immédiatement au routage proxy habituel.
  • Configurez vos outils CLI pour faire confiance à la CA du proxy d’entreprise : faites pointer git, curl, npm, Python, Homebrew, Claude Code et Cursor vers votre fichier PEM de CA d’entreprise exporté (SSL_CERT_FILE, NODE_EXTRA_CA_CERTS, REQUESTS_CA_BUNDLE, git http.sslCAInfo) au lieu de désactiver la vérification SSL de manière non sécurisée. Voir Corriger les erreurs de certificats TLS et SSL liés à une SWG dans les outils CLI et IA.
  • Demandez un contournement ou une exception de déchiffrement sur la passerelle IT : fournissez à l’équipe informatique les noms d’hôte exacts en échec (y compris les domaines de connexion et CDN) ainsi que les preuves de certificats issues de SWG bar afin qu’elle ajoute une règle centrale Do Not Decrypt ou External Domains List. Comparez les deux approches dans Contournement de SWG vs exception d’inspection TLS.