Voltar às atualizações
New releaseAug 21, 2026

retire.js v5.5.0

scanner que detecta o uso de bibliotecas JavaScript com vulnerabilidades conhecidas. Também pode gerar um SBOM das bibliotecas que encontra.

Compartilhar

Retire.js

O que você exige, você também deve aposentar

Existe um vasto ecossistema de bibliotecas JavaScript disponíveis tanto para aplicações web quanto para Node.js. Embora essas bibliotecas acelerem significativamente o desenvolvimento, elas também exigem manutenção contínua para garantir que as vulnerabilidades de segurança sejam tratadas prontamente. Em 2013, "Usar Componentes com Vulnerabilidades Conhecidas" foi adicionado à lista OWASP Top 10 de riscos críticos de segurança, destacando a séria ameaça que dependências desatualizadas ou inseguras podem representar para aplicações web. O Retire.js foi criado para ajudar os desenvolvedores a identificar versões de bibliotecas JavaScript com vulnerabilidades conhecidas, especialmente aquelas que não estão em manifestos de pacotes, mas simplesmente baixadas e colocadas no controle de código-fonte.

O Retire.js pode ser usado de várias formas:

  1. Como scanner de linha de comando
  2. Como extensão do Chrome - Não está disponível oficialmente na Chrome web store
  3. Como extensão do Burp ou Add-on do ZAP
  4. Como extensão do Firefox - Build de desenvolvimento do Manifest V3; consulte as instruções de instalação.
  5. Um scanner de sites headless
  6. Como plugin do grunt (obsoleto)
  7. Como tarefa do gulp (obsoleto)

Scanner de linha de comando

Escaneie um aplicativo web ou aplicativo node em busca do uso de bibliotecas JavaScript vulneráveis e/ou módulos Node.JS. Se você ainda não fez isso, primeiro você precisa instalar o node/npm. Na pasta do código-fonte da pasta da aplicação, execute:

$ npm install -g retire
$ retire

Geração de SBOM

O retire.js pode gerar SBOMs no formato CycloneDX:

$ retire --outputformat cyclonedx

cyclonedx produz CycloneDX 1.4 XML. Para JSON, e para versões mais recentes da especificação, use cyclonedxJSON (1.4), cyclonedxJSON1_6 ou cyclonedxJSON1_7. As variantes cyclonedxJSON1_6_VEX e cyclonedxJSON1_7_VEX também incluem uma seção vulnerabilities.

Por padrão, o retire.js encerrará com o código 13 se encontrar vulnerabilidades. Isso pode ser substituído com --exitwith 0.

Extensões do Chrome e Firefox

Escaneia sites visitados em busca de bibliotecas JavaScript com vulnerabilidades conhecidas. O selo da barra de ferramentas e o Analyst Console compartilhado exibem detecções, detalhes de avisos, busca e exportação JSON. Consulte as instruções de desenvolvimento para Chrome e Firefox.

Extensão para Burp e Add-on para ZAP

@h3xstream adaptou o Retire.js como um plugin para as ferramentas de teste de penetração Burp.

A equipe do ZAP oferece suporte oficial a um add-on do Retire.js, disponível no ZAP Marketplace e incluído por padrão nas versões semanais do ZAP: https://www.zaproxy.org/docs/desktop/addons/retire.js/

Scanner de sites headless

O retire-site-scanner https://github.com/RetireJS/retire-site-scanner pode ser usado para escanear um site em modo headless (em oposição ao uso das extensões do chrome/firefox)

Plugin Grunt (obsoleto)

Uma tarefa Grunt para executar o Retire.js como parte da rotina de build da sua aplicação, ou de algum outro fluxo de trabalho automatizado.

Tarefa Gulp (obsoleta)

Um exemplo de tarefa Gulp que pode ser usada no seu gulpfile para observar e escanear automaticamente os arquivos do seu projeto. Você pode modificar os padrões de observação e as opções (opcionais) do Retire.js como desejar.

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

Doar

As doações serão usadas para financiar a manutenção da ferramenta e do repositório de vulnerabilidades.

Categorias