« 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.

Réglez-le avec votre agentCopie un prompt pour Claude Code, Codex ou tout agent capable d’utiliser Terminal.

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.

S’applique à : Node.js, npm et les outils construits sur Node.js, sur toutes les versions actuelles de macOS.Vérifié le 29 octobre 2026

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

  1. Lisez l’émetteur.

    curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer
  2. Affichez le fichier d’autorités que npm utilise.

    npm config get cafile
  3. Affichez la variable d’autorités de Node.js.

    echo $NODE_EXTRA_CA_CERTS
  4. Essayez le partage de connexion d’un téléphone.

Comment corriger

  1. Demandez le certificat de l’autorité à l’administrateur du réseau, au format PEM.

  2. Indiquez à Node.js de lui faire confiance pour ce shell.

    export NODE_EXTRA_CA_CERTS=/path/to/ca.pem
  3. Pour npm, définissez le même fichier.

    npm config set cafile /path/to/ca.pem
  4. Ne définissez pas NODE_TLS_REJECT_UNAUTHORIZED=0. Cela désactive toutes les vérifications.

Avec Kilobat

  1. 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/
  2. Ces vérifications Kilobat sont gratuites. Les agents IA les lancent via MCP avec diagnose_connection et diagnose_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.