Ispezione SSL Zscaler su Mac: come verificare e aggirare per dominio

Verifica se Zscaler Client Connector decifra HTTPS sul tuo Mac, perché terminare ZCC fallisce sotto Tamper Protection e come aggirare per dominio o configurare l’attendibilità CA CLI.

SWG bar · Aggiornato

Per verificare se Zscaler (ZIA / Zscaler Client Connector) sta decifrando il traffico HTTPS sul tuo Mac, apri SWG bar → Panoramica (oppure esegui swgbar overview) e controlla se il Tasso di ispezione dei domini supera 0% con una Zscaler Root CA o una CA intermedia aziendale elencata in Certificati man-in-the-middle. Per aggirare l’ispezione SSL di Zscaler per un singolo nome host bloccato su un Mac autorizzato, apri SWG bar → Domini, seleziona il nome host e attiva Aggira SWG (oppure esegui swgbar bypass enable <domain>).

La maggior parte delle guide online per aggirare Zscaler presuppone l’accesso al Zscaler Admin Portal (ZIA). Su un MacBook aziendale gestito con Jamf, Kandji o Intune, sviluppatori e dipendenti dispongono raramente di accesso al portale — eppure Z-Tunnel 2.0 di Zscaler (tunnel NetworkExtension / utun) e la Zscaler Root CA interrompono regolarmente app con certificate pinning, Homebrew, npm, git, Python, Docker, Claude Code e Cursor.

1. Verifica se Zscaler sta ispezionando attivamente HTTPS sul tuo Mac

Poiché l’MDM preinstalla e rende attendibile la Zscaler Root CA nel Portachiavi di macOS, Safari e Chrome mostrano un lucchetto normale anche mentre Zscaler esegue l’HTTPS break-and-inspect. Verifica la decifratura per dominio con uno dei due metodi:

  • Controllo continuo con SWG bar: installa SWG bar (macOS 14+ su chip Apple, prova gratuita di 14 giorni di utilizzo) e visita i siti interessati. Apri SWG bar → Domini o Certificati — oppure esegui swgbar probe <domain> — per vedere se il dominio è Confermato come intercettato da Zscaler Root CA (o dalla CA intermedia Zscaler della tua azienda) oppure se passa con un Percorso pubblico.
  • Controllo puntuale di un dominio nel Terminale:
openssl s_client -connect api.github.com:443 -servername api.github.com </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject

Se issuer= mostra Zscaler o la CA intermedia Zscaler personalizzata della tua organizzazione invece di una CA pubblica (come DigiCert, Let’s Encrypt o Google Trust Services), l’ispezione SSL di Zscaler è attiva per quel nome host. Consulta Verificare i certificati TLS con openssl e security verify-cert su Mac per confrontare le impronte SHA-256.

2. Perché disconnettersi o scaricare Zscaler Client Connector non funziona

Provare a disattivare globalmente Zscaler su un Mac gestito quasi sempre si ritorce contro:

  • Tamper Protection: la maggior parte degli App Profile aziendali di ZCC richiede una password IT monouso per effettuare il logout o disattivare Internet Security (ZIA), e sudo launchctl bootout system /Library/LaunchDaemons/com.zscaler.* viene bloccato o riavviato all’istante.
  • Z-Tunnel 2.0 ignora le impostazioni Proxy di sistema: disattivare i proxy HTTP/HTTPS del Wi-Fi nelle Impostazioni di Sistema di macOS non ha alcun effetto sull’instradamento dei pacchetti di Z-Tunnel 2.0.
  • Accesso aziendale interrotto: anche se ZCC si arresta, le app interne ZPA (Zscaler Private Access) e l’SSO vincolato alla postura del dispositivo (Okta, Entra ID) smettono di funzionare.

3. Tre modi pratici per gestire l’ispezione SSL di Zscaler su macOS

Approccio Chi lo controlla Mantiene attivi ZCC e l’SSO aziendale? Caso d’uso migliore
Bypass SWG per dominio (SWG bar) Utente locale del Mac (su reti autorizzate) Sì — instrada solo il nome host selezionato tramite l’interfaccia fisica IPv4 Hardware del Mac Soluzione immediata a livello di nome host per app con pinning, WebSocket o API di sviluppo bloccate senza disattivare ZCC (Come aggirare una SWG su Mac)
Esclusione nel Zscaler Admin Portal (Do Not Inspect / App Profile) Team IT / Sicurezza aziendale Sì Esenzione permanente a livello organizzativo in Policy → SSL Inspection → Do Not Inspect o App Profiles → Hostname/IP Bypass per macOS (Bypass SWG vs eccezione all’ispezione TLS)
Esportare e rendere attendibile Zscaler Root CA negli strumenti CLI Sviluppatore locale Sì (il traffico resta ispezionato) La policy aziendale impone il passaggio decifrato e git, npm, brew, Python, Claude Code o Cursor falliscono con unable to get local issuer certificate

4. Attiva il bypass per dominio o configura Zscaler Root CA per gli strumenti CLI

Opzione A: Bypass per dominio con SWG bar (quando autorizzato)

  1. Apri SWG bar → Domini, individua il nome host esatto che fallisce (ricorda che i domini di login, API e CDN sono nomi host distinti — vedi Aggirare il SWG per app web multidominio, SSO, CDN e API) e fai clic su Attiva il bypass per questo dominio accanto ad Aggira SWG — oppure esegui swgbar bypass enable <domain>.
  2. Attendi lo stato Bypass attivo, quindi riavvia la scheda del browser, l’IDE o la sessione CLI affinché le connessioni in pool si riaprano sul percorso diretto IPv4 Hardware.
  3. Verifica con swgbar probe <domain> che ora venga restituita la catena di certificati pubblica del server di origine. Se un firewall blocca le connessioni dirette in uscita, esegui swgbar bypass disable <domain> per ripristinare subito il normale instradamento Zscaler.

Opzione B: Configura gli strumenti CLI e IA per considerare attendibile Zscaler Root CA

Se le policy di rete richiedono che il traffico rimanga decifrato da Zscaler, esporta il bundle PEM di Zscaler Root CA da Accesso Portachiavi (oppure richiedi il file PEM all’IT) e configura i tuoi runtime anziché disabilitare la verifica 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"

Per istruzioni complete sui runtime Homebrew, Docker Desktop, Python, Node.js, Claude Code e Cursor, leggi Attendibilità CA per Homebrew, Docker, Python e Node.js e Risolvere gli errori dei certificati in Claude Code e Cursor su macOS.