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
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.
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_BUNDLEohttp.sslCAInfosecondo le linee guida di sicurezza IT. Non disabilitare mai la verifica TLS (NODE_TLS_REJECT_UNAUTHORIZED=0osslVerify=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. Per confrontare le regole di instradamento locali con le esclusioni tramite criteri sul gateway, consulta Bypass SWG vs eccezione all’ispezione TLS.