Come aggirare l’ispezione SSL di un proxy aziendale e SWG su Mac

Perché disattivare i Proxy in Impostazioni di Sistema su macOS o usare networksetup fallisce contro i proxy SWG trasparenti, e come aggirare per dominio o correggere gli errori dei certificati CLI.

SWG bar · Aggiornato

Se disattivare gli interruttori proxy del Wi-Fi in Impostazioni di Sistema → Rete → Proxy — oppure aggiungere domini tramite networksetup -setproxybypassdomains — lascia comunque il tuo Mac dietro l’ispezione SSL del proxy aziendale, il dispositivo sta utilizzando un agente Secure Web Gateway (SWG) trasparente (NetworkExtension o tunnel utun) anziché un semplice proxy HTTP esplicito. Per aggirare l’ispezione SWG per un nome host specifico 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 dei tutorial sui proxy macOS confonde due architetture aziendali completamente diverse: i proxy espliciti / file PAC tradizionali e i moderni agenti SWG trasparenti (come Cisco Umbrella / Cisco Secure Client, Broadcom Cloud SWG, Zscaler, Netskope o Cloudflare Gateway). Capire quale delle due utilizza il tuo Mac spiega immediatamente perché le modifiche standard ai proxy non hanno effetto — e quale soluzione funziona davvero.

1. Verifica se il tuo Mac usa un proxy esplicito o un SWG trasparente

Esegui due rapidi controlli per vedere come viene indirizzato il traffico su macOS:

  1. Esamina le impostazioni esplicite del proxy di sistema:
scutil --proxy

Cerca HTTPEnable : 1, HTTPSEnable : 1 oppure ProxyAutoConfigURLString (un URL .pac). 2. Esamina l’effettiva intercettazione dei certificati HTTPS: apri SWG bar → Panoramica (oppure esegui swgbar overview / swgbar domains list --status confirmed).

  • Se scutil --proxy è vuoto, ma SWG bar riporta un Tasso di ispezione dei domini > 0% (con domini Confermato o Sospetto e Certificati man-in-the-middle), il tuo Mac si trova dietro un agente SWG trasparente (NetworkExtension / utun) che cattura i pacchetti al di sotto delle impostazioni Proxy di sistema di macOS.
  • Se scutil --proxy elenca un proxy aziendale o un PAC e SWG bar mostra una CA radice MITM aziendale, il traffico viene instradato attraverso un proxy di intercettazione esplicito o basato su PAC.

2. Proxy esplicito vs proxy SWG trasparente su macOS

Architettura Dove macOS intercetta il traffico Impostazioni di Sistema → Proxy / networksetup lo aggirano? Cosa funziona su un Mac autorizzato
Proxy esplicito HTTP/HTTPS o PAC (non gestito) Campi proxy di System Configuration in macOS Sì, se non bloccato da MDM (Ignora impostazioni proxy per questi host e domini) Elenco di esclusione proxy di macOS oppure verifica dell’instradamento per dominio
Proxy esplicito bloccato via MDM o SWG trasparente (NetworkExtension / utun) Filtro socket e IP a livello kernel / NetworkExtension sotto gli interruttori proxy del browser No — le impostazioni sono bloccate, sovrascritte o completamente ignorate dal tunnel SWG Bypass fisico IPv4 Hardware per dominio tramite SWG bar (Come aggirare una SWG su Mac), esclusioni IT del gateway External Domains / Do Not Decrypt, oppure configurazione del bundle CA per CLI

3. Aggirare l’ispezione SSL del proxy SWG per un dominio specifico su macOS

Quando una specifica app web, un endpoint API o un client desktop con certificate pinning fallisce dietro un proxy SWG aziendale su una rete che amministri o sei autorizzato a configurare:

  1. Installa e apri SWG bar (macOS 14+ su chip Apple, prova gratuita di 14 giorni di utilizzo) e riproduci la richiesta in modo che il nome host esatto compaia in Domini.
  2. Apri i dettagli del nome host e fai clic su Attiva il bypass per questo dominio nella riga Aggira SWG — oppure esegui:
swgbar bypass enable <domain>
swgbar bypass status
  1. Attendi Bypass attivo, quindi ricarica la pagina web o riavvia il client da Terminale/desktop affinché i socket keep-alive esistenti si riaprano tramite l’interfaccia fisica IPv4 Hardware del Mac (en0 / en7).
  2. Verifica con swgbar probe <domain> che venga presentata correttamente la catena di certificati pubblica dell’origine. Tieni presente che, se un’applicazione imposta autonomamente il proprio proxy esplicito (ad esempio HTTP_PROXY / HTTPS_PROXY in ~/.zshrc, ~/.npmrc o ~/.gitconfig), dovrai rimuovere quelle variabili proxy per quell’host affinché l’app non forzi di nuovo il traffico sulla porta del proxy esplicito.

4. Quando non puoi aggirare il proxy: esclusioni IT e bundle CA per CLI

Se il firewall aziendale blocca tutto il traffico IPv4 diretto in uscita che non attraversa il proxy SWG (un perimetro fail-closed):

  • Disattiva il bypass per dominio (swgbar bypass disable <domain>) così il nome host torna subito al normale instradamento via proxy.
  • Configura gli strumenti CLI per considerare attendibile la CA del proxy aziendale: indirizza git, curl, npm, Python, Homebrew, Claude Code e Cursor al file PEM esportato della CA aziendale (SSL_CERT_FILE, NODE_EXTRA_CA_CERTS, REQUESTS_CA_BUNDLE, git http.sslCAInfo) invece di disabilitare in modo insicuro la verifica SSL. Consulta Risolvere gli errori dei certificati TLS e SSL di SWG negli strumenti CLI e IA su Mac.
  • Richiedi un bypass o un’eccezione di decifratura sul gateway IT: fornisci al reparto IT i nomi host esatti che falliscono (inclusi domini di login e CDN) e le evidenze dei certificati raccolte con SWG bar, in modo che possano aggiungere una regola centrale Do Not Decrypt o External Domains List. Confronta entrambi i livelli in Bypass SWG vs eccezione all’ispezione TLS.