Come aggirare l’ispezione HTTPS e TLS su macOS (guida break-and-inspect)

Aggira la decifratura HTTPS e TLS break-and-inspect su macOS per singolo dominio con SWG bar: perché la terminazione TLS blocca HTTP/2, QUIC e pinning, più la verifica da CLI.

SWG bar · Aggiornato

Per aggirare l’ispezione HTTPS o TLS (break-and-inspect) per un dominio specifico su macOS senza disattivare globalmente il client di sicurezza, apri SWG bar → Domini, seleziona il nome host e attiva Aggira SWG (oppure esegui swgbar bypass enable <domain>). Attendi che la riga mostri Bypass attivo, quindi riavvia la scheda del browser, l’IDE o la sessione CLI in modo che un nuovo handshake TLS venga stabilito tramite l’interfaccia fisica IPv4 Hardware del tuo Mac.

I Secure Web Gateway (SWG) aziendali e i firewall di nuova generazione ispezionano il traffico HTTPS agendo come un man-in-the-middle attendibile: terminano l’handshake TLS 1.2/1.3 in uscita dal tuo Mac, analizzano i payload HTTP decifrati e cifrano nuovamente il traffico verso il server di origine. Sebbene i browser accettino silenziosamente la CA radice del gateway installata via MDM, i protocolli moderni e i client di sviluppo più rigorosi spesso si interrompono quando TLS viene rifirmato.

Cosa interrompe concretamente l’ispezione HTTPS / TLS break-and-inspect su un Mac

Anche quando il tuo Mac considera attendibile il certificato radice aziendale nel Portachiavi, la terminazione TLS inline compromette quattro flussi di lavoro comuni su macOS:

  1. Certificate pinning e mutual TLS (mTLS): le app che fissano la chiave pubblica del server di origine o presentano un certificato client interrompono l’handshake non appena un gateway sostituisce il certificato foglia con il proprio. Vedi Perché app con certificate pinning e mTLS falliscono sotto ispezione SWG.
  2. HTTP/3 (QUIC) e stream HTTP/2 o WebSocket di lunga durata: i gateway che effettuano downgrade o proxying delle connessioni TLS spesso scartano gli stream UDP QUIC, bloccano le risposte LLM in streaming o reimpostano i canali IDE/WebSocket persistenti.
  3. Archivi CA indipendenti di CLI e linguaggi: runtime come Node.js, Python, Git, Homebrew, Docker, Claude Code e Cursor includono propri archivi di CA radice e restituiscono errori come CERTIFICATE_VERIFY_FAILED o UNABLE_TO_GET_ISSUER_CERT_LOCALLY.
  4. API di sviluppo sensibili alla latenza: convogliare ogni handshake TLS attraverso un PoP SWG cloud distante aggiunge latenza di andata e ritorno alle installazioni di pacchetti, ai git fetch e al completamento del codice in tempo reale.

Bypass TLS per dominio vs impostazioni proxy locali ed eccezioni del gateway

Aspetto Bypass per dominio (SWG bar) Eccezione di ispezione TLS dell’amministratore (Do Not Decrypt) Modifiche proxy locali (Impostazioni di Sistema → Proxy)
Livello Instradamento IPv4 fisico a livello di nome host tramite NetworkExtension di macOS Criterio centrale di decifratura su SWG / firewall Solo campi proxy HTTP/HTTPS espliciti del sistema operativo
Funziona contro SWG trasparenti? Sì, quando è raggiungibile un percorso IPv4 fisico Sì (configurato dall’IT) No — ignorato o sovrascritto da agenti SWG trasparenti / utun
Richiede la console admin IT? No (controllo locale su un Mac autorizzato) Sì (portale admin Zscaler, Netskope, Cloudflare, Palo Alto) No
Preserva device posture / SSO? Sì — l’agente endpoint aziendale resta in esecuzione Sì Spesso compromette l’instradamento PAC aziendale

Per un approfondimento architetturale sul confronto tra modifiche di instradamento ed esclusioni di decifratura del gateway, leggi Bypass SWG vs eccezione all’ispezione TLS.

Aggirare l’ispezione HTTPS e TLS per un dominio su macOS

  1. Individua ogni nome host ispezionato: apri SWG bar → Domini oppure esegui swgbar domains list --status confirmed tramite la CLI. Ricorda che example.com, auth.example.com e api.example.com sono nomi host separati.
  2. Attiva il bypass per dominio: fai clic su Attiva il bypass per questo dominio nella riga Aggira SWG del dominio, oppure esegui:
swgbar bypass enable api.example.com
swgbar bypass status
  1. Chiudi le connessioni TLS e HTTP/3 in pool: aggiornare una singola scheda del browser può riutilizzare un socket HTTP/2 o QUIC già aperto lungo il percorso ispezionato. Il bypass nativo di SWG bar esegue il fallback di HTTP/3 su HTTPS tramite TCP sulle nuove connessioni, quindi ricarica la scheda oppure chiudi e riapri l’app interessata dopo la comparsa di Bypass attivo.
  2. Verifica la nuova catena di certificati: esegui swgbar probe api.example.com (oppure openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null) per verificare che venga restituito l’emittente pubblico del server di origine.

Se compare Ripristino in corso… o Bypass in pausa invece di Bypass attivo, consulta Risolvere Ripristino in corso…, Bypass in pausa ed errori SWG su Mac.

Disattivare il bypass o passare all’attendibilità CA quando necessario

Fai nuovamente clic sul controllo attivo Aggira SWG — oppure esegui swgbar bypass disable <domain> — per riportare immediatamente un nome host al normale instradamento del gateway. Anche chiudere SWG bar interrompe subito il bypass attivo conservando però le selezioni dei domini salvate per l’avvio successivo.

Se la tua rete blocca il traffico IPv4 diretto in uscita a livello di firewall, disattiva il bypass e utilizza le soluzioni di attendibilità CA per CLI e strumenti IA oppure richiedi all’amministratore una regola Do Not Decrypt per il nome host esatto.