« SELF_SIGNED_CERT_IN_CHAIN » dans npm sur Mac

SELF_SIGNED_CERT_IN_CHAIN signifie que la chaîne de certificats contient un certificat qu’aucune autorité connue n’a signé. Sur un réseau professionnel, la source habituelle est un proxy qui inspecte le TLS.

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 : « SELF_SIGNED_CERT_IN_CHAIN » dans npm sur Mac. Lis https://kilobat.app/fr/guides/npm-self-signed-cert-in-chain.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 à : npm sur toutes les versions actuelles de macOS. L’erreur apparaît aussi dans d’autres outils Node.js.Vérifié le 29 octobre 2026

Symptômes

  • npm install s’arrête avec npm error code SELF_SIGNED_CERT_IN_CHAIN.
  • Le message indique self-signed certificate in certificate chain.
  • Cela commence sur un réseau d’entreprise, ou après l’installation d’une app de sécurité.

Causes probables

  • Un proxy qui inspecte le TLS. Le proxy remplace le certificat du registre par le sien. Voir Les certificats de proxy d’entreprise cassent les outils Terminal sur Mac.
  • Une app de sécurité qui analyse le HTTPS. Elle peut ajouter sa propre racine au trafic.
  • Un vieux npm. La page des erreurs courantes de npm indique que npm ne prend plus en charge ses anciens certificats auto-signés.
  • Un registre privé. Un registre doté d’une autorité privée exige le certificat de cette autorité.

Comment vérifier

  1. Lisez l’émetteur du certificat du registre.

    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. Vérifiez la version de npm.

    npm --version
  4. Essayez le partage de connexion d’un téléphone. Si cela fonctionne, le premier réseau inspecte le TLS.

Comment corriger

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

  2. Indiquez-le à npm.

    npm config set cafile /path/to/ca.pem
  3. Mettez npm à jour s’il est ancien.

    npm install npm -g
  4. Ne réglez pas strict-ssl sur false. La documentation de npm le déconseille.

Avec Kilobat

  1. Le diagnostic de connexion de Kilobat teste le registre 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

npm config set strict-ssl false est-il sans risque ?

Cela désactive la vérification des certificats. La documentation de npm le déconseille pour les erreurs de proxy. Ajoutez plutôt l’autorité du proxy.

Pourquoi l’erreur n’apparaît-elle qu’au travail ?

Un proxy qui inspecte le TLS signe le trafic avec son propre certificat. Votre Mac ne lui fait pas confiance.

Sources

Vérifié le 29 octobre 2026.