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

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 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.

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.
  • Test e sviluppo locali autorizzati: sulle reti che amministri o sei autorizzato a testare, utilizza il bypass SWG per singolo dominio 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.