Corriger les erreurs de certificats TLS et SSL liés à une SWG dans les outils CLI et IA sur Mac
Dépannez les erreurs CERTIFICATE_VERIFY_FAILED et d’autorité locale dans git, npm, Python, Claude Code et Cursor derrière une SWG sur macOS.
SWG bar · Mis à jour
Lorsqu’un Mac d’entreprise se trouve derrière une passerelle web sécurisée (SWG) pratiquant l’inspection HTTPS/SSL (break-and-inspect), Safari et Chrome chargent souvent les sites web sans avertissement alors que les outils dans Terminal et les agents de développement IA échouent avec des erreurs de négociation TLS telles que SSL: CERTIFICATE_VERIFY_FAILED, UNABLE_TO_GET_ISSUER_CERT_LOCALLY ou SSL certificate problem: unable to get local issuer certificate.
Cet écart s’explique par le fait que les navigateurs interrogent le Trousseau macOS — où le MDM peut installer l’autorité racine (CA) d’inspection de votre organisation — tandis que de nombreux environnements en ligne de commande (git, curl, Node.js/npm, Python/pip) et outils d’IA (Claude Code, Cursor, serveurs MCP) valident les certificats à partir de leurs propres magasins d’autorités publiques intégrés.
1. Confirmer quel nom d’hôte subit une inspection HTTPS
Avant de modifier vos variables d’environnement ou vos réglages réseau, vérifiez si la chaîne de certificats du point de terminaison en échec est effectivement remplacée sur votre Mac :
- Installez et ouvrez SWG bar sur macOS 14 ou version ultérieure (puce Apple).
- Exécutez une fois la commande qui échoue, puis consultez SWG bar → Domaines — ou sondez directement le point de terminaison exact depuis Terminal grâce à la CLI intégrée :
/Applications/SWGBar.app/Contents/MacOS/swgbar probe registry.npmjs.org
/Applications/SWGBar.app/Contents/MacOS/swgbar domains detail registry.npmjs.org
- Examinez le classement et l’autorité racine (CA). Gardez à l’esprit que les interfaces web, les serveurs d’authentification, les registres de paquets et les points de terminaison d’API de LLM utilisent souvent des noms d’hôte différents : un sous-domaine peut passer sans modification pendant qu’un autre est déchiffré.
Si vous utilisez un assistant compatible MCP, vous pouvez également connecter le serveur MCP intégré de SWG bar afin que votre client IA interroge directement les domaines et chaînes de certificats observés.
2. Choisir la solution adaptée à votre environnement
Une fois confirmé qu’une CA racine d’inspection signe le certificat du nom d’hôte cible, choisissez l’une des trois approches suivantes selon votre politique réseau et vos autorisations :
| Approche | Fonctionnement | Recommandé lorsque |
|---|---|---|
| Configurer la confiance CA pour l’outil | Faites pointer l’environnement d’exécution (par exemple via NODE_EXTRA_CA_CERTS, SSL_CERT_FILE ou REQUESTS_CA_BUNDLE) vers un fichier PEM exporté contenant la CA racine d’entreprise. |
La politique d’entreprise impose un routage SWG inspecté et vous faites confiance à cette CA pour l’outil concerné. |
| Demander une exception d’inspection TLS à l’administrateur | Le service informatique exclut le nom d’hôte de l’API ou du registre du déchiffrement HTTPS sur la passerelle tout en conservant le routage par celle-ci. | Des outils à certificate pinning ou des points de terminaison utilisés par toute l’équipe échouent avec le break-and-inspect. |
| Activer le contournement SWG par domaine dans SWG bar | Achemine le nom d’hôte sélectionné sur macOS sans déchiffrement HTTPS de la passerelle via la barre des menus, la CLI ou MCP. | Vous administrez le réseau ou êtes autorisé à tester un chemin non inspecté pour certains domaines sur votre Mac. |
Consultez Contournement de SWG vs exception d’inspection TLS pour une comparaison architecturale détaillée entre les exceptions sur la passerelle et les changements de route.
3. Contourner un domaine inspecté sur macOS lorsque vous y êtes autorisé
Si le contournement par domaine est approprié sur votre réseau, vous pouvez l’activer pour le nom d’hôte exact de l’API ou du registre depuis la barre des menus (SWG bar → Domaines → Contourner la SWG → Activer le contournement pour ce domaine) ou depuis Terminal :
/Applications/SWGBar.app/Contents/MacOS/swgbar bypass enable registry.npmjs.org
/Applications/SWGBar.app/Contents/MacOS/swgbar bypass status
Une fois que l’état indique Contournement actif, relancez la commande CLI, le démon en arrière-plan ou l’hôte d’extensions de votre IDE afin que les connexions existantes se ferment et se rétablissent selon la nouvelle règle. Suivez Comment contourner une SWG sur Mac pour l’approbation initiale de l’extension réseau macOS, le comportement au redémarrage et la désactivation du contournement une fois terminé.
Garder à l’esprit les limites de la plateforme et du réseau
- Portée par nom d’hôte : Contourner
example.comn’inclut pas automatiquementapi.example.comniauth.example.com. Vérifiez chaque nom d’hôte contacté par votre outil. - Prérequis réseau : SWG bar 2.4.12 requiert macOS 14+ sur puce Apple et un chemin IPv4 disponible via une interface réseau physique. Si un pare-feu bloque les connexions sortantes directes ou si l’outil impose son propre proxy explicite, désactivez la règle de contournement et privilégiez une exception TLS administrateur ou la configuration d’un bundle CA.
- Vérifier avec des preuves récentes : Effectuez un nouveau contrôle à l’aide du guide sur l’inspection HTTPS et SSL après chaque modification plutôt que de vous fier à des résultats en cache.