Torna agli aggiornamenti
New releaseAug 21, 2026

retire.js v5.5.0

scanner che rileva l'uso di librerie JavaScript con vulnerabilità note. Può anche generare un SBOM delle librerie che trova.

Condividi

Retire.js

Ciò che richiedi devi anche ritirarlo

Esiste un vasto ecosistema di librerie JavaScript disponibili sia per applicazioni web che Node.js. Sebbene queste librerie accelerino notevolmente lo sviluppo, richiedono anche una manutenzione continua per garantire che le vulnerabilità di sicurezza vengano affrontate tempestivamente. Nel 2013, "Utilizzo di componenti con vulnerabilità note" è stato aggiunto alla lista OWASP Top 10 dei rischi critici per la sicurezza, evidenziando la grave minaccia che dipendenze obsolete o non sicure possono rappresentare per le applicazioni web. Retire.js è stato creato per aiutare gli sviluppatori a identificare le versioni delle librerie JavaScript con vulnerabilità note, in particolare quelle che non sono nei manifest dei pacchetti, ma semplicemente scaricate e inserite nel controllo del codice sorgente.

Retire.js può essere utilizzato in molti modi:

  1. Come scanner da riga di comando
  2. Come estensione Chrome - Non ufficialmente disponibile nel Chrome web store
  3. Come estensione Burp o Add-on ZAP
  4. Come estensione Firefox - Build di sviluppo Manifest V3; consultare le istruzioni di installazione.
  5. Uno scanner headless per siti web
  6. Come plugin grunt (deprecato)
  7. Come task gulp (deprecato)

Scanner da riga di comando

Analizza un'app web o un'app node per l'utilizzo di librerie JavaScript e/o moduli Node.JS vulnerabili. Se non l'hai già fatto, devi prima installare node/npm. Nella cartella del codice sorgente della cartella dell'applicazione esegui:

$ npm install -g retire
$ retire

Generazione SBOM

retire.js può generare SBOM nel formato CycloneDX:

$ retire --outputformat cyclonedx

cyclonedx produce XML CycloneDX 1.4. Per JSON, e per versioni più recenti delle specifiche, usa cyclonedxJSON (1.4), cyclonedxJSON1_6 o cyclonedxJSON1_7. Le varianti cyclonedxJSON1_6_VEX e cyclonedxJSON1_7_VEX includono anche una sezione vulnerabilities.

Per impostazione predefinita retire.js terminerà con codice 13 se trova vulnerabilità. Questo comportamento può essere sovrascritto con --exitwith 0.

Estensioni per Chrome e Firefox

Analizzano i siti visitati alla ricerca di librerie JavaScript con vulnerabilità note. Il badge della barra degli strumenti e la Analyst Console condivisa mostrano i rilevamenti, i dettagli degli advisory, la ricerca e l'esportazione JSON. Consulta le istruzioni di sviluppo per Chrome e Firefox.

Estensione per Burp e Add-on per ZAP

@h3xstream ha adattato Retire.js come plugin per gli strumenti di penetration testing Burp.

Il team di ZAP supporta ufficialmente un add-on per Retire.js, disponibile tramite lo ZAP Marketplace e incluso per impostazione predefinita nelle release settimanali di ZAP: https://www.zaproxy.org/docs/desktop/addons/retire.js/

Scanner di siti headless

Il retire-site-scanner https://github.com/RetireJS/retire-site-scanner può essere utilizzato per analizzare un sito web in modalità headless (in alternativa all'uso delle estensioni per chrome/firefox)

Plugin Grunt (deprecato)

Un task Grunt per eseguire Retire.js come parte della routine di build della tua applicazione, o di un altro flusso di lavoro automatizzato.

Task Gulp (deprecato)

Un esempio di task Gulp che può essere utilizzato nel tuo gulpfile per monitorare e analizzare automaticamente i file del tuo progetto. Puoi modificare i pattern di watch e le opzioni (facoltative) di Retire.js come preferisci.

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();
  });
});

Dona

Le donazioni saranno utilizzate per finanziare la manutenzione dello strumento e del repository delle vulnerabilità.

Categorie