Retour aux mises à jour
New releaseAug 21, 2026

retire.js v5.5.0

scanner détectant l'utilisation de bibliothèques JavaScript présentant des vulnérabilités connues. Peut également générer un SBOM des bibliothèques qu'il trouve.

Partager

Retire.js

Ce dont vous avez besoin, vous devez aussi le retirer

Il existe un vaste écosystème de bibliothèques JavaScript disponibles pour les applications web et Node.js. Bien que ces bibliothèques accélèrent considérablement le développement, elles nécessitent également une maintenance continue afin de garantir que les vulnérabilités de sécurité soient traitées rapidement. En 2013, « Utilisation de composants présentant des vulnérabilités connues » a été ajouté à la liste OWASP Top 10 des risques de sécurité critiques, soulignant la menace sérieuse que des dépendances obsolètes ou non sécurisées peuvent représenter pour les applications web. Retire.js a été créé pour aider les développeurs à identifier les versions de bibliothèques JavaScript présentant des vulnérabilités connues, en particulier celles qui ne figurent pas dans les manifestes de paquets, mais qui sont simplement téléchargées et placées dans le contrôle de source.

Retire.js peut être utilisé de plusieurs manières :

  1. Comme scanner en ligne de commande
  2. Comme extension Chrome - Non officiellement disponible dans le Chrome web store
  3. Comme extension Burp ou module complémentaire ZAP
  4. Comme extension Firefox - Build de développement Manifest V3 ; voir les instructions d'installation.
  5. Un scanner de site web headless
  6. Comme plugin grunt (obsolète)
  7. Comme tâche gulp (obsolète)

Scanner en ligne de commande

Analysez une application web ou une application node pour détecter l'utilisation de bibliothèques JavaScript et/ou de modules Node.JS vulnérables. Si ce n'est pas déjà fait, vous devez d'abord installer node/npm. Dans le dossier du code source du dossier de l'application, exécutez :

$ npm install -g retire
$ retire

Génération de SBOM

retire.js peut générer des SBOM au format CycloneDX :

$ retire --outputformat cyclonedx

cyclonedx produit du XML CycloneDX 1.4. Pour le JSON, et pour les versions plus récentes de la spécification, utilisez cyclonedxJSON (1.4), cyclonedxJSON1_6 ou cyclonedxJSON1_7. Les variantes cyclonedxJSON1_6_VEX et cyclonedxJSON1_7_VEX incluent également une section vulnerabilities.

Par défaut, retire.js se terminera avec le code 13 s'il trouve des vulnérabilités. Cela peut être modifié avec --exitwith 0.

Extensions Chrome et firefox

Analyse les sites visités à la recherche de bibliothèques JavaScript présentant des vulnérabilités connues. Le badge de la barre d'outils et la console Analyste partagée affichent les détections, les détails des avis, la recherche et l'export JSON. Consultez les instructions de développement pour Chrome et Firefox.

Extension Burp et module complémentaire ZAP

@h3xstream a adapté Retire.js sous forme de plugin pour les outils de test d'intrusion Burp.

L'équipe ZAP prend officiellement en charge un module complémentaire Retire.js, disponible via le ZAP Marketplace et inclus par défaut dans les versions hebdomadaires de ZAP : https://www.zaproxy.org/docs/desktop/addons/retire.js/

Scanner de site sans interface graphique

Le retire-site-scanner https://github.com/RetireJS/retire-site-scanner peut être utilisé pour analyser un site web en mode sans interface graphique (par opposition à l'utilisation des extensions chrome/firefox)

Plugin Grunt (obsolète)

Une tâche Grunt pour exécuter Retire.js dans le cadre de la routine de build de votre application, ou de tout autre workflow automatisé.

Tâche Gulp (obsolète)

Un exemple de tâche Gulp pouvant être utilisée dans votre gulpfile pour surveiller et analyser automatiquement les fichiers de votre projet. Vous pouvez modifier les motifs de surveillance et les options (facultatives) de Retire.js à votre convenance.

const c = require("ansi-colors");

var gulp = require("gulp");
var beeper = require("beeper");
var log = require("fancy-log");
var spawn = require("child_process").spawn;

gulp.task("retire:watch", ["retire"], function (done) {
  // Watch all javascript files and package.json
  gulp.watch(["js/**/*.js", "package.json"], ["retire"]);
});

gulp.task("retire", function () {
  // Spawn Retire.js as a child process
  // You can optionally add option parameters to the second argument (array)
  var child = spawn("retire", [], { cwd: process.cwd() });

  child.stdout.setEncoding("utf8");
  child.stdout.on("data", function (data) {
    log(data);
  });

  child.stderr.setEncoding("utf8");
  child.stderr.on("data", function (data) {
    log(c.red(data));
    beeper();
  });
});

Faire un don

Les dons serviront à financer la maintenance de l'outil et du dépôt de vulnérabilités.

Catégories