Source: https://swgbar.com/it/guides/netskope-ssl-inspection-bypass-mac/
Language: it

# 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 19 novembre 2026

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](<https://swgbar.com/it/install/>) (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](<https://swgbar.com/it/chrome-extension/>) 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](<https://swgbar.com/it/guides/how-to-bypass-swg/>)) |
| **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](<https://swgbar.com/it/guides/swg-bypass-vs-tls-exception/>)) |
| **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](<https://swgbar.com/it/guides/swg-tls-certificate-errors-macos/>) e [Attendibilità CA per Homebrew, Docker, Python e Node.js](<https://swgbar.com/it/guides/homebrew-docker-python-node-ca-trust-swg-macos/>) per le configurazioni specifiche per strumento.

## 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 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/>)
*   [Perché app con certificate pinning e mTLS falliscono sotto ispezione SWG](<https://swgbar.com/it/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [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/>)
