Confiance CA Homebrew, Docker, Python et Node.js derrière une SWG sur Mac
Pourquoi Homebrew, Docker Desktop, Node.js, Python, git et curl rejettent les certificats TLS signés par une SWG sur macOS, et comment choisir entre bundles CA et contournement SWG.
SWG bar · Mis à jour
Sur un Mac d’entreprise placé derrière une inspection HTTPS break-and-inspect, chaque environnement de développement valide les certificats TLS différemment. Alors que Safari et Chrome consultent le Trousseau macOS, les outils en ligne de commande et les conteneurs utilisent souvent leurs propres bundles CA — ce qui provoque des échecs soudains dans les gestionnaires de paquets et SDK.
Pourquoi les outils de développement Mac échouent de façon sélective
| Outil / Environnement | Magasin de confiance par défaut sur macOS | Variable d’environnement ou réglage courant |
|---|---|---|
| Node.js / npm / yarn / pnpm | Magasin CA Mozilla intégré à la compilation | NODE_EXTRA_CA_CERTS=/path/to/corp-ca.pem |
| Python / pip / uv / requests | Bundle certifi ou chemin CA OpenSSL |
SSL_CERT_FILE / REQUESTS_CA_BUNDLE |
| git | OpenSSL ou Secure Transport selon la compilation | git config --global http.sslCAInfo /path/to/corp-ca.pem |
curl / Homebrew (brew) |
Secure Transport macOS ou bundle CA OpenSSL | HOMEBREW_CURLRC / CURL_CA_BUNDLE (vérifiez curl --version) |
| Docker Desktop / Conteneurs | VM Linux et /etc/ssl/certs de l’image (hors Trousseau macOS) |
Ajouter la CA d’entreprise au magasin de confiance de la VM / image Docker |
1. Identifier quel nom d’hôte de registre ou d’API est inspecté
Avant de modifier vos profils shell ou builds de conteneurs, vérifiez quels noms d’hôtes externes exacts subissent une inspection SSL au lieu d’échouer à cause d’un blocage DNS ou pare-feu :
swgbar domains list --status confirmed
swgbar probe registry.npmjs.org
swgbar probe pypi.org
swgbar probe ghcr.io
Gardez à l’esprit que les gestionnaires de paquets redirigent souvent les téléchargements vers plusieurs hôtes (par exemple formulae.brew.sh → ghcr.io, ou github.com → objects.githubusercontent.com). Voir Contourner la SWG pour applications web multi-domaines, SSO, CDN et API.
2. Choisir entre bundle CA, exception TLS et contournement SWG
- Ajouter le fichier PEM de la CA racine d’entreprise : lorsque la politique d’entreprise impose le déchiffrement SWG pour tout le trafic, exportez la CA racine exacte identifiée dans SWG bar → Certificats et configurez
NODE_EXTRA_CA_CERTS,SSL_CERT_FILE,REQUESTS_CA_BUNDLEouhttp.sslCAInfoconformément aux directives de sécurité informatique. Ne désactivez jamais la vérification TLS (NODE_TLS_REJECT_UNAUTHORIZED=0ousslVerify=false). - Demander une exception d’inspection TLS au service informatique : recommandé pour les registres partagés, images de base Docker ou outils à certificate pinning strict où maintenir des bundles CA personnalisés entre CI et postes locaux est fragile.
- Utiliser le contournement SWG par domaine sur les réseaux autorisés : lorsque vous administrez ou êtes autorisé à contourner des hôtes précis sur votre Mac, activez Contourner la SWG dans SWG bar (ou
swgbar bypass enable <domain>) et redémarrez le processus CLI.
Comparer les approches avant de modifier les réglages système
Pour résoudre étape par étape les erreurs CERTIFICATE_VERIFY_FAILED, lisez Corriger les erreurs de certificats TLS et SSL liés à une SWG dans les outils CLI et IA sur Mac. Pour comparer les règles locales de routage aux exclusions de politique sur la passerelle, consultez Contournement de SWG vs exception d’inspection TLS.