---
title: "« UNABLE_TO_GET_ISSUER_CERT_LOCALLY » sur Mac · Guides Kilobat"
url: "https://kilobat.app/fr/guides/npm-unable-to-get-issuer-cert-locally"
description: "Node.js ou npm s’arrête sur votre Mac avec UNABLE_TO_GET_ISSUER_CERT_LOCALLY. L’émetteur d’un certificat est inconnu. Ajoutez le bon fichier d’autorités, ne désactivez pas les vérifications."
---

# « 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 agent**Copie 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](https://kilobat.app/fr/guides/corporate-proxy-certificates).
- **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](https://kilobat.app/fr/guides/recipes/why-cant-it-connect).

## 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

- [Documentation npm : erreurs courantes](https://docs.npmjs.com/common-errors)
- [Claude Code : configuration réseau en entreprise](https://code.claude.com/docs/en/network-config.md)

Vérifié le 29 octobre 2026.

## Guides associés

- [« SELF_SIGNED_CERT_IN_CHAIN » dans npm sur Mac](https://kilobat.app/fr/guides/npm-self-signed-cert-in-chain): SELF_SIGNED_CERT_IN_CHAIN signifie que la chaîne de certificats contient un certificat qu’aucune autorité connue n’a signé.
- [Les certificats de proxy d’entreprise bloquent les outils de Terminal sur un Mac](https://kilobat.app/fr/guides/corporate-proxy-certificates): Certains réseaux d’entreprise inspectent le trafic HTTPS.
- [« curl: (60) SSL certificate problem » sur Mac](https://kilobat.app/fr/guides/curl-60-ssl-certificate-problem): Le code de sortie 60 de curl signale une étape en échec.
- [« npm error code ECONNRESET » sur Mac](https://kilobat.app/fr/guides/npm-econnreset): ECONNRESET indique qu’une connexion a été réinitialisée de force.
