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

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

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](<https://swgbar.com/it/guides/certificate-pinning-mtls-swg-inspection-macos/>).
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](<https://swgbar.com/it/guides/swg-bypass-vs-tls-exception/>).

## 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](<https://swgbar.com/it/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
```

3.  **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**.
4.  **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](<https://swgbar.com/it/guides/troubleshoot-swg-bypass-recovering-paused-macos/>).

## 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](<https://swgbar.com/it/guides/swg-tls-certificate-errors-macos/>) oppure richiedi all’amministratore una regola **Do Not Decrypt** per il nome host esatto.

## 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 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 Zscaler su Mac: come verificare e aggirare per dominio](<https://swgbar.com/it/guides/zscaler-ssl-inspection-bypass-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/>)
