Source: https://swgbar.com/it/guides/homebrew-docker-python-node-ca-trust-swg-macos/
Language: it

# Attendibilità CA per Homebrew, Docker, Python e Node.js dietro un SWG su Mac

Perché Homebrew, Docker Desktop, Node.js, Python, git e curl rifiutano i certificati TLS firmati dal SWG su macOS e come scegliere tra bundle CA e bypass SWG.

SWG bar · Aggiornato 18 novembre 2026

Su un Mac aziendale dietro un’ispezione HTTPS break-and-inspect, ciascun runtime di sviluppo convalida i certificati TLS in modo diverso. Mentre Safari e Chrome consultano il **Portachiavi di macOS**, gli strumenti da riga di comando e i container usano spesso i propri bundle CA, causando improvvisi errori di compilazione tra gestori di pacchetti e SDK.

## Perché i vari strumenti di sviluppo su Mac falliscono in modo selettivo

| Strumento / Runtime | Archivio di attendibilità predefinito su macOS | Variabile d’ambiente o impostazione comune |
| --- | --- | --- |
| **Node.js / npm / yarn / pnpm** | Bundle CA Mozilla compilato internamente | `NODE_EXTRA_CA_CERTS=/path/to/corp-ca.pem` |
| **Python / pip / uv / requests** | Bundle `certifi` o percorso CA OpenSSL | `SSL_CERT_FILE` / `REQUESTS_CA_BUNDLE` |
| **git** | OpenSSL o Secure Transport a seconda della build | `git config --global http.sslCAInfo /path/to/corp-ca.pem` |
| **curl / Homebrew (`brew`)** | Secure Transport di macOS o bundle CA OpenSSL | `HOMEBREW_CURLRC` / `CURL_CA_BUNDLE` (verifica con `curl --version`) |
| **Docker Desktop / Container** | VM Linux e `/etc/ssl/certs` dell’immagine (non il Portachiavi di macOS) | Aggiungi la CA aziendale all’archivio della VM Docker o dell’immagine |

## 1\. Individua quale registro o nome host API viene intercettato

Prima di modificare i profili della shell o le build dei container, conferma quali esatti nomi host esterni sono sottoposti a ispezione SSL anziché fallire per blocchi DNS o del firewall:

```
swgbar domains list --status confirmed
swgbar probe registry.npmjs.org
swgbar probe pypi.org
swgbar probe ghcr.io
```

Tieni presente che i gestori di pacchetti reindirizzano spesso i download su più host (ad esempio `formulae.brew.sh` → `ghcr.io`, oppure `github.com` → `objects.githubusercontent.com`). Vedi [Aggirare il SWG per app web multidominio, SSO, CDN e API](<https://swgbar.com/it/guides/multi-domain-sso-api-cdn-swg-bypass/>).

## 2\. Scegli tra configurazione del bundle CA, eccezione TLS o bypass SWG

*   **Aggiungi in coda il PEM della CA radice aziendale**: quando i criteri aziendali richiedono che tutto il traffico sia sottoposto a decifratura SWG, esporta la CA radice esatta individuata in **SWG bar → Certificati** e configura `NODE_EXTRA_CA_CERTS`, `SSL_CERT_FILE`, `REQUESTS_CA_BUNDLE` o `http.sslCAInfo` secondo le linee guida di sicurezza IT. Non disabilitare mai la verifica TLS (`NODE_TLS_REJECT_UNAUTHORIZED=0` o `sslVerify=false`).
*   **Richiedi all’IT un’eccezione all’ispezione TLS**: soluzione consigliata per registri condivisi, immagini base Docker o strumenti con certificate pinning rigoroso, dove mantenere bundle CA personalizzati tra CI e macchine locali risulta fragile.
*   **Usa il bypass SWG per singolo dominio sulle reti autorizzate**: quando amministri o sei autorizzato ad aggirare host specifici sul tuo Mac, attiva **Aggira SWG** in SWG bar (oppure `swgbar bypass enable <domain>`) e riavvia il processo CLI.

## Confronta i flussi prima di modificare i valori predefiniti di sistema

Per la risoluzione passo passo degli errori `CERTIFICATE_VERIFY_FAILED`, leggi [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/>). Per confrontare le regole di instradamento locali con le esclusioni tramite criteri sul gateway, consulta [Bypass SWG vs eccezione all’ispezione TLS](<https://swgbar.com/it/guides/swg-bypass-vs-tls-exception/>).

## 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/>)
*   [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/>)
*   [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/>)
