Inspection SSL Zscaler sur Mac : comment vérifier et contourner par domaine

Vérifiez si Zscaler Client Connector déchiffre HTTPS sur votre Mac, pourquoi arrêter ZCC échoue sous protection anti-altération, et contournez par domaine ou configurez la CA CLI.

SWG bar · Mis à jour

Pour vérifier si Zscaler (ZIA / Zscaler Client Connector) déchiffre le trafic HTTPS sur votre Mac, ouvrez SWG bar → Vue d’ensemble (ou exécutez swgbar overview) et vérifiez si le Taux d’inspection des domaines dépasse 0% avec une Zscaler Root CA ou une CA intermédiaire d’entreprise listée dans Certificats d’interception (MITM). Pour contourner l’inspection SSL Zscaler pour un seul nom d’hôte en erreur 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 guides en ligne expliquant comment contourner Zscaler supposent que vous avez accès au Zscaler Admin Portal (ZIA). Sur un MacBook d’entreprise géré par Jamf, Kandji ou Intune, les développeurs et employés disposent rarement d’un accès au portail — pourtant Z-Tunnel 2.0 (tunnel NetworkExtension / utun) et la Zscaler Root CA cassent régulièrement les applications à certificate pinning, Homebrew, npm, git, Python, Docker, Claude Code et Cursor.

1. Vérifier si Zscaler inspecte activement HTTPS sur votre Mac

Comme le MDM préinstalle et approuve la Zscaler Root CA dans le trousseau macOS, Safari et Chrome affichent un cadenas normal même lorsque Zscaler effectue un HTTPS break-and-inspect. Vérifiez le déchiffrement domaine par domaine avec l’une des deux méthodes :

  • Contrôle continu avec SWG bar : installez SWG bar (macOS 14+ puce Apple, essai gratuit de 14 jours d’utilisation) et visitez les sites concernés. Ouvrez SWG bar → Domaines ou Certificats — ou exécutez swgbar probe <domain> — pour voir si le domaine est classé Confirmé (intercepté par Zscaler Root CA ou par la CA intermédiaire Zscaler de votre société) ou s’il passe avec un Chemin public.
  • Contrôle ponctuel d’un domaine dans Terminal :
openssl s_client -connect api.github.com:443 -servername api.github.com </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject

Si issuer= indique Zscaler ou la CA intermédiaire Zscaler personnalisée de votre organisation au lieu d’une CA publique (telle que DigiCert, Let’s Encrypt ou Google Trust Services), l’inspection SSL Zscaler est active pour ce nom d’hôte. Consultez Vérifier les certificats TLS avec OpenSSL et security verify-cert pour contre-vérifier les empreintes SHA-256.

2. Pourquoi se déconnecter ou décharger Zscaler Client Connector échoue

Essayer de désactiver Zscaler globalement sur un Mac géré se retourne presque toujours contre vous :

  • Protection anti-altération (Tamper Protection) : la plupart des profils d’application ZCC d’entreprise exigent un mot de passe unique fourni par l’IT pour se déconnecter ou désactiver Internet Security (ZIA), et sudo launchctl bootout system /Library/LaunchDaemons/com.zscaler.* est bloqué ou immédiatement relancé.
  • Z-Tunnel 2.0 ignore les réglages de proxy système : désactiver les interrupteurs de proxy HTTP/HTTPS Wi-Fi dans les Réglages Système de macOS n’a aucun effet sur le routage des paquets par Z-Tunnel 2.0.
  • Rupture de l’accès d’entreprise : même si ZCC s’arrête, les applications internes ZPA (Zscaler Private Access) et le SSO conditionné à la posture de l’appareil (Okta, Entra ID) cessent de fonctionner.

3. Trois approches pratiques face à l’inspection SSL Zscaler sur macOS

Approche Qui la contrôle Maintient ZCC et le SSO d’entreprise actifs ? Meilleur cas d’usage
Contournement SWG par domaine (SWG bar) Utilisateur local du Mac (sur réseaux autorisés) Oui — achemine uniquement le nom d’hôte sélectionné via l’interface physique IPv4 Matériel de votre Mac Soulagement immédiat par nom d’hôte pour les apps épinglées, WebSockets ou API développeurs cassées sans désactiver ZCC (Comment contourner une SWG sur Mac)
Exclusion dans Zscaler Admin Portal (Do Not Inspect / App Profile) Équipe IT / Sécurité d’entreprise Oui Exemption permanente à l’échelle de l’organisation sous Policy → SSL Inspection → Do Not Inspect ou macOS App Profiles → Hostname/IP Bypass (Contournement de SWG vs exception TLS)
Exporter et approuver Zscaler Root CA dans les outils CLI Développeur local Oui (le trafic reste inspecté) La politique d’entreprise impose un routage déchiffré et git, npm, brew, Python, Claude Code ou Cursor échouent avec unable to get local issuer certificate

4. Activer le contournement par domaine ou configurer Zscaler Root CA pour les outils CLI

Option A : contournement par domaine avec SWG bar (si autorisé)

  1. Ouvrez SWG bar → Domaines, repérez le nom d’hôte exact en échec (notez que les domaines de connexion, d’API et de CDN sont des noms d’hôte distincts — voir contourner la SWG pour applications web multi-domaines, SSO, CDN et API), puis cliquez sur Activer le contournement pour ce domaine dans la ligne Contourner la SWG — ou exécutez swgbar bypass enable <domain>.
  2. Attendez l’état Contournement actif, puis redémarrez l’onglet du navigateur, l’IDE ou la session CLI afin que les connexions groupées se rouvrent sur la route directe IPv4 Matériel.
  3. Vérifiez avec swgbar probe <domain> que la chaîne de certificats publique du serveur d’origine est désormais renvoyée. Si un pare-feu bloque les connexions sortantes directes, exécutez swgbar bypass disable <domain> pour rétablir aussitôt le routage Zscaler normal.

Option B : configurer les outils CLI et IA pour faire confiance à Zscaler Root CA

Si votre politique réseau exige que le trafic reste déchiffré par Zscaler, exportez votre bundle PEM Zscaler Root CA depuis Trousseau d’accès (ou demandez le fichier PEM à l’IT) et configurez vos runtimes plutôt que de désactiver la vérification SSL :

# Node.js, npm, Claude Code, Cursor
export NODE_EXTRA_CA_CERTS="$HOME/.certs/zscaler-root.pem"

# Python (pip, requests), OpenSSL, Homebrew curl
export SSL_CERT_FILE="$HOME/.certs/zscaler-root.pem"
export REQUESTS_CA_BUNDLE="$HOME/.certs/zscaler-root.pem"
export CURL_CA_BUNDLE="$HOME/.certs/zscaler-root.pem"

# Git
git config --global http.sslCAInfo "$HOME/.certs/zscaler-root.pem"

Pour les instructions complètes couvrant Homebrew, Docker Desktop, Python, Node.js, Claude Code et Cursor, lisez Configurer la confiance CA pour Homebrew, Docker, Python et Node.js et Corriger les erreurs de certificats Claude Code et Cursor sur macOS.