Source: https://swgbar.com/it/guides/swg-tls-certificate-errors-macos/
Language: it

# Risolvere gli errori dei certificati TLS e SSL di SWG negli strumenti CLI e IA su Mac

Risolvi gli errori CERTIFICATE\_VERIFY\_FAILED e di certificato dell’emittente locale in git, npm, Python, Claude Code e Cursor dietro un SWG su macOS.

SWG bar · Aggiornato 18 novembre 2026

Quando un Mac aziendale si trova dietro un Secure Web Gateway (SWG) che esegue **ispezione HTTPS/SSL (break-and-inspect)**, Safari e Chrome spesso caricano i siti web senza avvisi mentre gli strumenti da Terminale e gli agenti di programmazione IA si bloccano con errori di handshake TLS come `SSL: CERTIFICATE_VERIFY_FAILED`, `UNABLE_TO_GET_ISSUER_CERT_LOCALLY` o `SSL certificate problem: unable to get local issuer certificate`.

Questa discrepanza si verifica perché i browser consultano il **Portachiavi di macOS** — dove l’MDM può installare la CA radice di ispezione dell’organizzazione — mentre molti ambienti a riga di comando (`git`, `curl`, `Node.js`/`npm`, `Python`/`pip`) e strumenti IA (`Claude Code`, `Cursor`, server MCP) convalidano i certificati rispetto ai propri archivi di CA pubbliche integrati.

## 1\. Conferma quale nome host è sottoposto a ispezione HTTPS

Prima di modificare variabili d’ambiente o impostazioni di rete, verifica se la catena di certificati dell’endpoint che restituisce errore viene effettivamente sostituita sul tuo Mac:

1.  [Installa e apri SWG bar](<https://swgbar.com/it/install/>) su macOS 14 o successivo (chip Apple).
2.  Esegui una volta il comando che fallisce, poi controlla **SWG bar → Domini** — oppure verifica direttamente l’endpoint esatto da Terminale con la [CLI](<https://swgbar.com/it/cli/>) integrata:

```
/Applications/SWGBar.app/Contents/MacOS/swgbar probe registry.npmjs.org
/Applications/SWGBar.app/Contents/MacOS/swgbar domains detail registry.npmjs.org
```

3.  Esamina la classificazione e la CA radice. Ricorda che interfacce web, server di autenticazione, registri di pacchetti ed endpoint API degli LLM utilizzano spesso nomi host diversi: un sottodominio può passare inalterato mentre un altro viene decifrato.

Se utilizzi un assistente compatibile con MCP, puoi anche collegare [il server MCP integrato di SWG bar](<https://swgbar.com/it/mcp/>) affinché il tuo client IA interroghi direttamente i domini e le catene di certificati osservati.

## 2\. Scegli la soluzione adatta al tuo ambiente

Dopo aver confermato che una CA radice di ispezione firma il certificato del nome host di destinazione, scegli uno dei tre approcci seguenti in base ai criteri di rete e alle tue autorizzazioni:

| Approccio | Come funziona | Ideale quando |
| --- | --- | --- |
| **Configurare l’attendibilità CA per lo strumento** | Indirizza il runtime (ad esempio tramite `NODE_EXTRA_CA_CERTS`, `SSL_CERT_FILE` o `REQUESTS_CA_BUNDLE`) a un bundle PEM esportato che includa la CA radice aziendale. | I criteri aziendali impongono l’instradamento ispezionato tramite SWG e consideri attendibile quella CA per lo specifico strumento. |
| **Richiedere un’eccezione all’ispezione TLS all’amministratore** | L’IT esclude il nome host dell’API o del registro dalla decifratura HTTPS sul gateway mantenendo l’instradamento tramite gateway. | Strumenti con _certificate pinning_ o endpoint di sviluppo condivisi dal team si bloccano con il break-and-inspect. |
| **Attivare il bypass SWG per dominio in SWG bar** | Instrada il nome host selezionato su macOS senza decifratura HTTPS del gateway tramite barra dei menu, CLI o MCP. | Amministri la rete o sei autorizzato a testare un percorso non ispezionato per specifici domini sul tuo Mac. |

Leggi [Bypass SWG vs eccezione all’ispezione TLS](<https://swgbar.com/it/guides/swg-bypass-vs-tls-exception/>) per un confronto architetturale dettagliato tra eccezioni sul gateway e modifiche del percorso di rete.

## 3\. Aggira un dominio ispezionato su macOS quando autorizzato

Se il bypass per dominio è appropriato per la tua rete, puoi attivarlo per il nome host esatto dell’API o del registro dalla barra dei menu (**SWG bar → Domini → Aggira SWG → Attiva il bypass per questo dominio**) oppure da Terminale:

```
/Applications/SWGBar.app/Contents/MacOS/swgbar bypass enable registry.npmjs.org
/Applications/SWGBar.app/Contents/MacOS/swgbar bypass status
```

Una volta che lo stato mostra **Bypass attivo**, riavvia il comando CLI, il demone in background o l’host delle estensioni dell’IDE affinché le connessioni esistenti si chiudano e si riconnettano seguendo la nuova regola. Segui [Come aggirare una SWG su Mac](<https://swgbar.com/it/guides/how-to-bypass-swg/>) per l’autorizzazione iniziale dell’estensione di rete di macOS, il comportamento al riavvio e la disattivazione del bypass al termine.

## Tieni presenti i limiti della piattaforma e della rete

*   **Ambito per singolo nome host**: Aggirare `example.com` non include automaticamente `api.example.com` o `auth.example.com`. Verifica ogni nome host contattato dal tuo strumento.
*   **Requisiti di rete**: SWG bar 2.4.12 richiede macOS 14+ su chip Apple e un percorso IPv4 disponibile tramite un’interfaccia di rete fisica. Se un firewall blocca le connessioni dirette in uscita o lo strumento impone un proprio proxy esplicito, disattiva la regola di bypass e usa invece un’eccezione TLS dell’amministratore o la configurazione di un bundle CA.
*   **Verifica con nuove evidenze**: Esegui un nuovo controllo seguendo [la guida all’ispezione HTTPS e SSL](<https://swgbar.com/it/guides/detect-https-inspection/>) dopo ogni modifica anziché affidarti a risultati memorizzati nella cache.

## 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 SSL Netskope su Mac: verificare la decifratura e aggirare per dominio](<https://swgbar.com/it/guides/netskope-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/>)
*   [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/>)
