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 confirmed per elencare ogni nome host il cui certificato TLS è stato rifirmato dalla CA del tuo tenant Netskope (solitamente nel formato ca.<tenant>.goskope.com oppure 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)

  1. Apri SWG bar → Domini, seleziona il nome host esatto ispezionato (ad esempio api.anthropic.com o pypi.org) e fai clic su Attiva il bypass per questo dominio accanto ad Aggira SWG — oppure esegui swgbar bypass enable <domain>.
  2. 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.
  3. 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 esegui swgbar 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.