Назад к обновлениям
New releaseAug 21, 2026

retire.js v5.5.0

сканер, обнаруживающий использование библиотек JavaScript с известными уязвимостями. Также может генерировать SBOM найденных библиотек.

Поделиться

Retire.js

Всё, что вы подключаете, вам придётся и выводить из эксплуатации

Существует обширная экосистема библиотек JavaScript, доступных как для веб-приложений, так и для приложений Node.js. Хотя эти библиотеки значительно ускоряют разработку, они также требуют постоянного сопровождения, чтобы уязвимости безопасности устранялись своевременно. В 2013 году категория «Использование компонентов с известными уязвимостями» была добавлена в список критических рисков безопасности OWASP Top 10, что подчеркнуло серьёзную угрозу, которую устаревшие или небезопасные зависимости могут представлять для веб-приложений. Retire.js был создан, чтобы помочь разработчикам выявлять версии библиотек JavaScript с известными уязвимостями, особенно те, которые отсутствуют в манифестах пакетов, а просто загружены и помещены в систему контроля версий.

Retire.js можно использовать несколькими способами:

  1. Как сканер командной строки
  2. Как расширение Chrome — Не доступно официально в интернет-магазине Chrome
  3. Как расширение Burp или дополнение ZAP
  4. Как расширение Firefox — сборка для разработки на Manifest V3; см. инструкции по установке.
  5. Сканер веб-сайтов без графического интерфейса
  6. Как плагин grunt (устарел)
  7. Как задача gulp (устарела)

Сканер командной строки

Сканирует веб-приложение или приложение node на предмет использования уязвимых библиотек JavaScript и/или модулей Node.JS. Если вы ещё этого не сделали, сначала необходимо установить node/npm. В папке с исходным кодом папки приложения выполните:

$ npm install -g retire
$ retire

Генерация SBOM

retire.js может генерировать SBOM в формате CycloneDX:

$ retire --outputformat cyclonedx

cyclonedx создаёт XML в формате CycloneDX 1.4. Для JSON и более новых версий спецификации используйте cyclonedxJSON (1.4), cyclonedxJSON1_6 или cyclonedxJSON1_7. Варианты cyclonedxJSON1_6_VEX и cyclonedxJSON1_7_VEX также включают раздел vulnerabilities.

По умолчанию retire.js завершит работу с кодом 13, если обнаружит уязвимости. Это можно переопределить с помощью --exitwith 0.

Расширения для Chrome и Firefox

Сканируют посещённые сайты на наличие JavaScript-библиотек с известными уязвимостями. Значок на панели инструментов и общая консоль Analyst Console показывают обнаружения, сведения об уведомлениях, поиск и экспорт в JSON. См. инструкции по разработке для Chrome и Firefox.

Расширение для Burp и дополнение для ZAP

@h3xstream адаптировал Retire.js в виде плагина для инструментов тестирования на проникновение Burp.

Команда ZAP официально поддерживает дополнение Retire.js, которое доступно через ZAP Marketplace и включено по умолчанию в еженедельные сборки ZAP: https://www.zaproxy.org/docs/desktop/addons/retire.js/

Сканер сайтов без графического интерфейса

retire-site-scanner https://github.com/RetireJS/retire-site-scanner можно использовать для сканирования веб-сайта в режиме без графического интерфейса (в отличие от использования расширений для chrome/firefox)

Плагин Grunt (устарел)

Задача Grunt для запуска Retire.js в рамках процедуры сборки вашего приложения или другого автоматизированного рабочего процесса.

Задача Gulp (устарела)

Пример задачи Gulp, которую можно использовать в вашем gulpfile для автоматического отслеживания и сканирования файлов проекта. Вы можете изменять шаблоны отслеживания и (необязательные) параметры Retire.js по своему усмотрению.

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

Пожертвовать

Пожертвования будут использованы для финансирования поддержки инструмента и репозитория уязвимостей.

Категории