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

# 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 18 novembre 2026

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 :

1.  [Installez et ouvrez SWG bar](<https://swgbar.com/fr/install/>) sur macOS 14 ou version ultérieure (puce Apple).
2.  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](<https://swgbar.com/fr/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
```

3.  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](<https://swgbar.com/fr/mcp/>) 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](<https://swgbar.com/fr/guides/swg-bypass-vs-tls-exception/>) 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](<https://swgbar.com/fr/guides/how-to-bypass-swg/>) 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.com` n’inclut pas automatiquement `api.example.com` ni `auth.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](<https://swgbar.com/fr/guides/detect-https-inspection/>) après chaque modification plutôt que de vous fier à des résultats en cache.

## Pour aller plus loin

*   [Comment contourner une SWG sur Mac (contournement par domaine en 1 clic et CLI)](<https://swgbar.com/fr/guides/how-to-bypass-swg/>)
*   [Comment contourner l’inspection SSL sur Mac (SWG d’entreprise et par domaine)](<https://swgbar.com/fr/guides/bypass-ssl-inspection-mac/>)
*   [Comment contourner l’inspection HTTPS et TLS sur macOS (guide break-and-inspect)](<https://swgbar.com/fr/guides/bypass-https-tls-inspection-mac/>)
*   [Comment contourner l’inspection SSL d’un proxy d’entreprise et d’une SWG sur Mac](<https://swgbar.com/fr/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [Comment savoir si votre Mac est intercepté par une SWG (inspection HTTPS et SSL)](<https://swgbar.com/fr/guides/detect-https-inspection/>)
*   [Comment vérifier si votre employeur ou Mac professionnel intercepte HTTPS (inspection SSL)](<https://swgbar.com/fr/guides/check-if-work-mac-intercepting-https/>)
*   [Vérificateur d’inspection SSL pour Mac : outil de barre des menus pour détecter l’interception HTTPS](<https://swgbar.com/fr/guides/ssl-inspection-checker-mac/>)
*   [Inspection SSL Zscaler sur Mac : comment vérifier et contourner par domaine](<https://swgbar.com/fr/guides/zscaler-ssl-inspection-bypass-mac/>)
*   [Inspection SSL Netskope sur Mac : vérifier le déchiffrement et contourner par domaine](<https://swgbar.com/fr/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Inspection TLS Cloudflare WARP et Zero Trust sur Mac : détecter et contourner](<https://swgbar.com/fr/guides/cloudflare-warp-tls-inspection-mac/>)
*   [Inspection HTTPS Confirmé vs Suspecté dans SWG bar](<https://swgbar.com/fr/guides/confirmed-vs-suspected-https-inspection/>)
*   [Inspecter les certificats racines MITM et les émetteurs dans SWG bar](<https://swgbar.com/fr/guides/inspect-mitm-root-certificates-macos/>)
*   [Inspection HTTPS par SWG d’entreprise et MDM sur Mac](<https://swgbar.com/fr/guides/enterprise-swg-https-inspection-macos/>)
*   [Contournement de SWG vs exception d’inspection TLS (break-and-inspect)](<https://swgbar.com/fr/guides/swg-bypass-vs-tls-exception/>)
*   [Contourner la SWG pour applications web multi-domaines, SSO, CDN et API sur Mac](<https://swgbar.com/fr/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [Corriger Restauration…, Contournement en pause et erreurs de connexion SWG sur Mac](<https://swgbar.com/fr/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [Interfaces virtuelles VPN macOS vs inspection HTTPS d’une SWG](<https://swgbar.com/fr/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [Pourquoi les apps à certificate pinning et mTLS cassent sous inspection SWG](<https://swgbar.com/fr/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [Confiance CA Homebrew, Docker, Python et Node.js derrière une SWG sur Mac](<https://swgbar.com/fr/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [Corriger 'unable to get local issuer certificate' dans Claude Code et Cursor sur Mac (SWG et MCP)](<https://swgbar.com/fr/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)
*   [Vérifier les certificats TLS avec openssl et security verify-cert sur Mac](<https://swgbar.com/fr/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [Autorisations de SWG bar, confidentialité locale et limites des sondes TLS](<https://swgbar.com/fr/guides/macos-network-extension-privacy-probe-limits/>)
*   [Comment SWG bar vérifie l’inspection HTTPS](<https://swgbar.com/fr/how-it-works/>)
*   [Télécharger et installer SWG bar pour Mac (macOS 14+)](<https://swgbar.com/fr/install/>)
*   [Extension Chrome pour détecter l’inspection SSL et HTTPS (compagnon SWG bar)](<https://swgbar.com/fr/chrome-extension/>)
*   [Guide de SWG bar CLI](<https://swgbar.com/fr/cli/>)
*   [Guide de SWG bar MCP](<https://swgbar.com/fr/mcp/>)
*   [Informations de version de SWG bar](<https://swgbar.com/fr/releases/>)
*   [À propos de SWG bar](<https://swgbar.com/fr/about/>)
