Source: https://swgbar.com/it/guides/zscaler-ssl-inspection-bypass-mac/
Language: it

# 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 19 novembre 2026

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](<https://swgbar.com/it/install/>) (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](<https://swgbar.com/it/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>) 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](<https://swgbar.com/it/guides/how-to-bypass-swg/>)) |
| **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](<https://swgbar.com/it/guides/swg-bypass-vs-tls-exception/>)) |
| **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](<https://swgbar.com/it/guides/multi-domain-sso-api-cdn-swg-bypass/>)) 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](<https://swgbar.com/it/guides/homebrew-docker-python-node-ca-trust-swg-macos/>) e [Risolvere gli errori dei certificati in Claude Code e Cursor su macOS](<https://swgbar.com/it/guides/ai-coding-agents-claude-code-cursor-swg-macos/>).

## Continua a leggere

*   [Come aggirare una SWG su Mac (bypass per dominio in 1 clic e CLI)](<https://swgbar.com/it/guides/how-to-bypass-swg/>)
*   [Come aggirare l’ispezione SSL su Mac (SWG aziendale e bypass per dominio)](<https://swgbar.com/it/guides/bypass-ssl-inspection-mac/>)
*   [Come aggirare l’ispezione HTTPS e TLS su macOS (guida break-and-inspect)](<https://swgbar.com/it/guides/bypass-https-tls-inspection-mac/>)
*   [Come aggirare l’ispezione SSL di un proxy aziendale e SWG su Mac](<https://swgbar.com/it/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [Come capire se il tuo Mac è intercettato da un SWG (ispezione HTTPS e SSL)](<https://swgbar.com/it/guides/detect-https-inspection/>)
*   [Come verificare se il datore di lavoro o il Mac aziendale intercetta HTTPS (ispezione SSL)](<https://swgbar.com/it/guides/check-if-work-mac-intercepting-https/>)
*   [Strumento di verifica dell’ispezione SSL per Mac: app nella barra dei menu per rilevare l’intercettazione HTTPS](<https://swgbar.com/it/guides/ssl-inspection-checker-mac/>)
*   [Ispezione SSL Netskope su Mac: verificare la decifratura e aggirare per dominio](<https://swgbar.com/it/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Ispezione TLS di Cloudflare WARP e Zero Trust su Mac: rilevare e aggirare](<https://swgbar.com/it/guides/cloudflare-warp-tls-inspection-mac/>)
*   [Ispezione HTTPS Confermato vs Sospetto in SWG bar](<https://swgbar.com/it/guides/confirmed-vs-suspected-https-inspection/>)
*   [Esaminare i certificati radice MITM e gli emittenti in SWG bar](<https://swgbar.com/it/guides/inspect-mitm-root-certificates-macos/>)
*   [Ispezione HTTPS di SWG aziendali e MDM su Mac](<https://swgbar.com/it/guides/enterprise-swg-https-inspection-macos/>)
*   [Bypass SWG vs eccezione all’ispezione TLS (break-and-inspect)](<https://swgbar.com/it/guides/swg-bypass-vs-tls-exception/>)
*   [Aggirare il SWG per app web multidominio, SSO, CDN e API su Mac](<https://swgbar.com/it/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [Risolvere Ripristino in corso…, Bypass in pausa ed errori SWG su Mac](<https://swgbar.com/it/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [Interfacce virtuali VPN di macOS vs ispezione HTTPS SWG](<https://swgbar.com/it/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [Perché app con certificate pinning e mTLS falliscono sotto ispezione SWG](<https://swgbar.com/it/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [Risolvere gli errori dei certificati TLS e SSL di SWG negli strumenti CLI e IA su Mac](<https://swgbar.com/it/guides/swg-tls-certificate-errors-macos/>)
*   [Attendibilità CA per Homebrew, Docker, Python e Node.js dietro un SWG su Mac](<https://swgbar.com/it/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [Risolvere 'unable to get local issuer certificate' in Claude Code e Cursor su Mac (SWG e MCP)](<https://swgbar.com/it/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)
*   [Verificare i certificati TLS con openssl e security verify-cert su Mac](<https://swgbar.com/it/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [Permessi di SWG bar, privacy locale e limiti delle sonde TLS](<https://swgbar.com/it/guides/macos-network-extension-privacy-probe-limits/>)
*   [Come SWG bar verifica l’ispezione HTTPS](<https://swgbar.com/it/how-it-works/>)
*   [Scarica e installa SWG bar per Mac (macOS 14+)](<https://swgbar.com/it/install/>)
*   [Estensione Chrome per rilevare l’ispezione SSL e HTTPS (estensione di SWG bar)](<https://swgbar.com/it/chrome-extension/>)
*   [Guida a SWG bar CLI](<https://swgbar.com/it/cli/>)
*   [Guida a SWG bar MCP](<https://swgbar.com/it/mcp/>)
*   [Informazioni sulle versioni di SWG bar](<https://swgbar.com/it/releases/>)
*   [Informazioni su SWG bar](<https://swgbar.com/it/about/>)
