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:
- Il Portachiavi di macOS dichiara valido il certificato del SWG.
- L’applicazione con pinning confronta l’impronta della chiave pubblica del certificato del SWG con il pin integrato.
- 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:
- Apri SWG bar e riproduci l’errore di connessione nella tua applicazione.
- 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. - 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.
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 CodeoCursorignorano il Portachiavi di macOS, segui Risolvere gli errori dei certificati TLS e SSL di SWG negli strumenti CLI e IA su Mac.