Source: https://swgbar.com/it/guides/certificate-pinning-mtls-swg-inspection-macos/
Language: it

# Perché app con certificate pinning e mTLS falliscono sotto ispezione SWG

Scopri perché le app che usano certificate pinning TLS o mutual TLS (mTLS) falliscono dietro l’ispezione HTTPS break-and-inspect di un SWG su macOS anche se l’MDM considera attendibile la CA radice.

SWG bar · Aggiornato 18 novembre 2026

Chi utilizza un Mac gestito tramite MDM nota spesso che i normali siti web funzionano senza problemi dietro un Secure Web Gateway (SWG) aziendale, mentre specifiche app desktop, programmi di aggiornamento di sicurezza, SDK mobile o API per sviluppatori falliscono immediatamente gli handshake TLS. Nella maggior parte dei casi, la causa è la collisione tra **certificate pinning** o **mutual TLS (mTLS)** e l’**ispezione HTTPS/SSL (break-and-inspect)** del SWG.

## Perché la fiducia nella CA radice MDM non risolve il certificate pinning

Durante la normale navigazione HTTPS, Safari e Chrome si fidano di qualsiasi catena di certificati valida ancorata a un’autorità presente nel **Portachiavi di macOS**, incluse le CA radice aziendali distribuite tramite MDM.

Le applicazioni che implementano il **certificate pinning TLS (HPKP / SPKI pinning)** vanno oltre: incorporano l’hash della chiave pubblica attesa (SPKI) o il certificato leaf/intermedio direttamente nel binario dell’app. Quando un SWG aziendale termina TLS e firma nuovamente il certificato con la propria CA radice interna:

1.  Il Portachiavi di macOS dichiara valido il certificato del SWG.
2.  L’applicazione con pinning confronta l’impronta della chiave pubblica del certificato del SWG con il pin integrato.
3.  Le impronte non corrispondono: l’applicazione interrompe subito l’handshake TLS per proteggersi da un’intercettazione man-in-the-middle.

## Perché il mutual TLS (mTLS) si interrompe durante il break-and-inspect

Con il **mutual TLS (mTLS)** si autenticano entrambe le parti: il client presenta un certificato client al server di origine prima che venga concesso l’accesso (meccanismo comune nelle API bancarie, negli endpoint B2B, nelle API zero-trust e nei servizi per sviluppatori con chiave hardware).

Se un SWG si interpone e termina la connessione TLS per decifrare i payload HTTP, il server di origine vede la connessione del SWG anziché l’handshake TLS client del tuo Mac — interrompendo la convalida end-to-end del certificato client, a meno che il gateway non operi esclusivamente come pass-through cifrato o escluda quell’host.

## Diagnostica quali nomi host vengono intercettati sul tuo Mac

Prima di chiedere all’IT una regola sul gateway o configurare una regola locale, individua il nome host esatto contattato dall’app con pinning o mTLS:

1.  Apri [SWG bar](<https://swgbar.com/it/install/>) e riproduci l’errore di connessione nella tua applicazione.
2.  Controlla **SWG bar → Domini** (oppure esegui `swgbar domains list --status confirmed`) per trovare il nome host esatto di API, CDN o aggiornamento contattato dall’app.
3.  Esamina i dettagli del dominio e la scheda **Certificati** per confermare se la CA radice del SWG aziendale sta terminando il traffico TLS per quell’host.

![Scheda Certificati di SWG bar che mostra le CA radice e il numero di domini associati; anteprima illustrativa.](<https://swgbar.com/optimized/panel-native-certificates-four-tabs-720.webp>)

_Verifica se il nome host API o di aggiornamento di un’app compare sotto un cluster di CA di ispezione in SWG bar._

## Scegli la risoluzione appropriata

*   **Flussi di lavoro aziendali gestiti e in produzione**: richiedi al tuo amministratore IT o di sicurezza un’**eccezione mirata all’ispezione TLS (regola di non decifratura)** per il nome host con pinning o mTLS, in modo che l’instradamento sul gateway resti intatto senza rompere il pinning TLS. Vedi [Bypass SWG vs eccezione all’ispezione TLS](<https://swgbar.com/it/guides/swg-bypass-vs-tls-exception/>).
*   **Test e sviluppo locali autorizzati**: sulle reti che amministri o sei autorizzato a testare, utilizza il [bypass SWG per singolo dominio](<https://swgbar.com/it/guides/how-to-bypass-swg/>) da **Domini** o `swgbar bypass enable <domain>` affinché quel nome host specifico si connetta senza decifratura del gateway.
*   **Errori di archivio CA nei runtime CLI e IA**: se l’errore non è dovuto a pinning rigoroso, bensì al fatto che `git`, `npm`, `Python`, `Claude Code` o `Cursor` ignorano il Portachiavi di macOS, segui [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/>).

## 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 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/>)
*   [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/>)
