Ispezione SSL Netskope su Mac: verificare la decifratura e aggirare per dominio
Verifica se Netskope Client sta decifrando HTTPS sul tuo Mac (CA *.goskope.com), confronta il bypass per dominio con SWG bar rispetto alla policy Do Not Decrypt e configura nscacert_combined.pem.
SWG bar · Aggiornato
Per verificare se Netskope Client sta eseguendo la decifratura SSL/TLS sul tuo Mac, apri SWG bar → Panoramica (oppure esegui swgbar overview) e controlla se il Tasso di ispezione dei domini è superiore a 0% con un certificato Netskope o del tenant *.goskope.com sotto Certificati man-in-the-middle. Per aggirare l’ispezione SSL di Netskope per uno specifico nome host su un Mac autorizzato, apri SWG bar → Domini, seleziona il nome host e fai clic su Attiva il bypass per questo dominio accanto ad Aggira SWG (oppure esegui swgbar bypass enable <domain>).
Netskope Secure Web Gateway è ampiamente distribuito sulle flotte macOS aziendali tramite un client di steering basato su NetworkExtension e una CA intermedia specifica del tenant. Poiché la CA radice di Netskope viene distribuita via MDM nel Portachiavi di macOS, i browser mostrano normali indicatori di sicurezza verdi/validi mentre i runtime CLI (pip, npm, AWS CLI, git, Docker, Claude Code) e le app desktop con certificate pinning falliscono con CERTIFICATE_VERIFY_FAILED o UNABLE_TO_GET_ISSUER_CERT_LOCALLY.
1. Verifica se Netskope sta decifrando un dominio sul tuo Mac
Controlla sia l’intercettazione a livello di sistema sia i singoli nomi host:
- Visibilità dalla barra dei menu e da Chrome con SWG bar: installa SWG bar (macOS 14+ su chip Apple, prova gratuita di 14 giorni di utilizzo) e naviga oppure esegui il comando in errore. Apri SWG bar → Domini oppure esegui
swgbar domains list --status confirmedper elencare ogni nome host il cui certificato TLS è stato rifirmato dalla CA del tuo tenant Netskope (solitamente nel formatoca.<tenant>.goskope.comoppure la CA personalizzata della tua azienda). Abbinalo gratuitamente all’estensione Chrome di SWG bar per vedere i badge di stato nella barra degli strumenti del browser. - Verifica i certificati Netskope e l’emittente live nel Terminale:
# Check whether a Netskope CA is installed in the macOS System Keychain
security find-certificate -c "Netskope" /Library/Keychains/System.keychain
# Inspect the live certificate issuer returned for a specific hostname
openssl s_client -connect registry.npmjs.org:443 -servername registry.npmjs.org </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject
Ricorda che i criteri di Netskope spesso decifrano alcuni domini SaaS o di hosting del codice mentre inoltrano altri senza toccarli: verifica sempre il nome host esatto che presenta l’errore.
2. Perché chiudere Netskope Client di solito non funziona
Negli ambienti gestiti in cui è attiva la policy anti-manomissione Protect Client configuration and resources di Netskope, l’opzione Disable nell’icona di Netskope nella barra dei menu è disabilitata o protetta da password, e forzare lo scaricamento del daemon interrompe l’instradamento di rete del sistema. Anche cancellare i campi proxy del Wi-Fi su macOS non ha effetto perché Netskope instrada il traffico al livello NetworkExtension di macOS.
3. Scegli la soluzione giusta per Netskope su macOS
| Metodo | Interrompe la decifratura Netskope? | Richiede l’amministratore del tenant Netskope? | Ideale quando |
|---|---|---|---|
Bypass SWG per dominio (SWG bar) |
Sì, per i nomi host selezionati su interfaccia fisica IPv4 Hardware |
No (controllo locale su un Mac autorizzato) | Un’app con pinning, un WebSocket o un endpoint di sviluppo fallisce sotto la decifratura Netskope ed esiste un percorso IPv4 diretto (Come aggirare una SWG su Mac) |
Eccezione Do Not Decrypt / Certificate Pinned Apps nel tenant Netskope |
Sì, centralmente su tutti i Mac gestiti | Sì (Policies → SSL Decryption → Do Not Decrypt oppure Steering Configuration → Exceptions) | App desktop con pinning o endpoint di sviluppo condivisi falliscono per tutto il team (Bypass SWG vs eccezione all’ispezione TLS) |
Bundle CA combinato (nscacert_combined.pem) per gli strumenti CLI |
No (il traffico rimane ispezionato) | No | I criteri richiedono l’instradamento decifrato tramite Netskope e gli strumenti CLI/IA devono soltanto fidarsi della catena CA Netskope |
4. Applica il bypass per dominio o configura l’attendibilità CA Netskope per la CLI
Opzione A: Bypass per dominio tramite SWG bar (quando autorizzato)
- Apri SWG bar → Domini, seleziona il nome host esatto ispezionato (ad esempio
api.anthropic.comopypi.org) e fai clic su Attiva il bypass per questo dominio accanto ad Aggira SWG — oppure eseguiswgbar bypass enable <domain>. - Attendi la comparsa di Bypass attivo, quindi riavvia la scheda del browser, lo strumento da Terminale o l’IDE in modo che le connessioni TLS/HTTP/3 in pool si riconnettano attraverso l’interfaccia fisica IPv4
Hardware. - Conferma con
swgbar probe <domain>che venga ora servita la catena di certificati pubblica dell’origine. Per ripristinare immediatamente lo stato precedente, fai clic sul controllo attivo oppure eseguiswgbar bypass disable <domain>.
Opzione B: Crea un bundle PEM combinato per gli strumenti CLI sotto Netskope
Se il traffico deve continuare a essere ispezionato da Netskope, esporta un bundle PEM combinato dagli archivi di attendibilità di macOS (oppure usa il bundle nscacert_combined.pem fornito dal team IT) e indirizza a esso gli strumenti di sviluppo in ~/.zshrc:
security find-certificate -a -p \
/System/Library/Keychains/SystemRootCertificates.keychain \
/Library/Keychains/System.keychain > "$HOME/.certs/nscacert_combined.pem"
export NODE_EXTRA_CA_CERTS="$HOME/.certs/nscacert_combined.pem"
export REQUESTS_CA_BUNDLE="$HOME/.certs/nscacert_combined.pem"
export SSL_CERT_FILE="$HOME/.certs/nscacert_combined.pem"
export AWS_CA_BUNDLE="$HOME/.certs/nscacert_combined.pem"
Consulta Risolvere gli errori dei certificati TLS e SSL di SWG negli strumenti CLI e IA su Mac e Attendibilità CA per Homebrew, Docker, Python e Node.js per le configurazioni specifiche per strumento.