Formations — 1 037 leçons en français

Accueil › Node.js › Dépendances et secrets

Dépendances et secrets

Sécuritéavance

Une dépendance n'est pas une bibliothèque : c'est du code que vous exécutez avec tous vos droits. Ses propres dépendances aussi, et vous ne les avez pas choisies. Une application Node banale installe quelques centaines de paquets.

Trois gestes

npm ci                     # installer exactement le verrou, sans le modifier
npm audit --omit=dev       # comparer l'arbre aux vulnérabilités connues
npm ls --all | wc -l       # mesurer ce qu'on exécute vraiment

npm install peut réécrire le verrou pour satisfaire un intervalle de versions : deux installations à deux dates donnent alors deux arbres différents, et un incident devient irreproductible. npm ci part du verrou et échoue s'il est incohérent.

Les scripts d'installation

Installer, c'est exécuter. Un paquet peut déclarer un script lancé à l'installation, avec les droits de l'utilisateur et l'accès aux variables d'environnement de la machine.

npm ci --ignore-scripts

Dans une intégration continue, c'est le réglage par défaut raisonnable ; on l'assouplit pour les rares paquets qui compilent du natif.

Les secrets

const url = process.env.DATABASE_URL;   // injecté par la plateforme, ou --env-file
if (!url) throw new Error("DATABASE_URL manquante");

Un secret vit dans l'environnement du processus ou dans un coffre. Jamais dans le dépôt, jamais dans une image, jamais dans un journal.

Et s'il a été poussé

Il est publié. Un objet Git reste accessible dans les clones et les caches, et la seule correction est la révocation du secret. Réécrire l'historique vient après, et ne remplace rien.

Les termes à connaître

Chaîne d'approvisionnement

L'ensemble du code que vous exécutez sans l'avoir écrit. Une dépendance de dépendance a exactement les mêmes droits que votre propre code.

Fichier de verrouillage

package-lock.json : la version et l'empreinte exactes de chaque paquet installé. Sans lui, deux installations ne donnent pas le même code.

Script de cycle de vie

Un postinstall qu'un paquet déclare et que l'installation exécute. Du code arbitraire lancé avant même que vous n'ayez importé quoi que ce soit.

Audit

La comparaison de l'arbre installé à une base de vulnérabilités connues. Nécessaire, insuffisant, et bruyant sur les dépendances de développement.

Secret

Une valeur dont la divulgation donne un accès. Elle vit dans l'environnement ou un coffre, jamais dans le dépôt, jamais dans un journal.

Rotation

Remplacer un secret par un nouveau, périodiquement ou après un doute. Un système incapable de tourner ses secrets ne peut pas réagir à une fuite.

Révocation

Rendre un secret inutilisable. C'est la seule correction possible pour un secret qui a été publié, l'historique Git compris.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.