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
postinstallqu'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.
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.