« UNABLE_TO_GET_ISSUER_CERT_LOCALLY » sur Mac
UNABLE_TO_GET_ISSUER_CERT_LOCALLY signifie que Node.js ne trouve pas l’autorité qui a signé un certificat. La cause habituelle est un proxy qui inspecte le TLS ou une autorité privée.
Mon Mac a ce problème : « UNABLE_TO_GET_ISSUER_CERT_LOCALLY » sur Mac. Lis https://kilobat.app/fr/guides/npm-unable-to-get-issuer-cert-locally.md et résous-le avec moi. Installe la CLI Kilobat si elle manque : brew install seifip/kilobat/kilobat. Lance toi-même les vérifications Terminal et kilobat du guide et dis-moi ce que tu trouves. Liste les étapes que moi seul peux faire. Demande-moi avant de modifier un réglage.
Symptômes
- Un outil Node.js s’arrête avec
UNABLE_TO_GET_ISSUER_CERT_LOCALLY. - Le message peut indiquer
unable to get local issuer certificate. - Les navigateurs peuvent ouvrir le même site.
Causes probables
- Un proxy qui inspecte le TLS. Un proxy professionnel signe le trafic avec son propre certificat. Voir Les certificats de proxy d’entreprise cassent les outils Terminal sur Mac.
- Une autorité privée. Un registre ou une passerelle d’entreprise utilise un certificat d’une autorité que Node.js ne connaît pas.
- Une app de sécurité qui analyse le HTTPS. Elle ajoute sa propre racine, que Node.js n’utilise pas par défaut.
- Un certificat intermédiaire manquant. Un serveur peut omettre une partie de sa chaîne de certificats.
Comment vérifier
Lisez l’émetteur.
curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuerAffichez le fichier d’autorités que npm utilise.
npm config get cafileAffichez la variable d’autorités de Node.js.
echo $NODE_EXTRA_CA_CERTSEssayez le partage de connexion d’un téléphone.
Comment corriger
Demandez le certificat de l’autorité à l’administrateur du réseau, au format PEM.
Indiquez à Node.js de lui faire confiance pour ce shell.
export NODE_EXTRA_CA_CERTS=/path/to/ca.pemPour npm, définissez le même fichier.
npm config set cafile /path/to/ca.pemNe définissez pas
NODE_TLS_REJECT_UNAUTHORIZED=0. Cela désactive toutes les vérifications.
Avec Kilobat
Le diagnostic de connexion de Kilobat teste l’hôte couche par couche. La couche TLS montre un certificat auquel ce Mac ne fait pas confiance.
kilobat why https://registry.npmjs.org/Ces vérifications Kilobat sont gratuites. Les agents IA les lancent via MCP avec
diagnose_connectionetdiagnose_network. Consultez Trouver pourquoi un site ou une API ne se connecte pas.
Questions
Pourquoi le navigateur fonctionne-t-il ?
macOS fait confiance aux certificats qu’un administrateur installe. Node.js utilise sa propre liste, sauf si vous ajoutez un fichier.
Définir NODE_TLS_REJECT_UNAUTHORIZED=0 est-il une solution ?
Non. Cela désactive la validation des certificats pour toutes les connexions. Ajoutez plutôt l’autorité.
Sources
Vérifié le 29 octobre 2026.