
retire.js v5.5.0
既知の脆弱性があるJavaScriptライブラリの使用を検出するスキャナー。見つけたライブラリのSBOMも生成できます。
Retire.js
必要なものは、同じく廃止しなければならない
WebアプリケーションとNode.jsアプリケーションの両方で利用可能なJavaScriptライブラリには、膨大なエコシステムが存在します。これらのライブラリは開発を大幅に加速させる一方で、セキュリティ脆弱性が迅速に対処されるよう、継続的なメンテナンスも必要とします。2013年、「既知の脆弱性を持つコンポーネントの使用」がOWASP Top 10の重大なセキュリティリスク一覧に追加され、古くなった、あるいは安全でない依存関係がWebアプリケーションに及ぼしうる深刻な脅威が浮き彫りになりました。Retire.jsは、既知の脆弱性を持つJavaScriptライブラリのバージョン、特にパッケージマニフェストには含まれず、単にダウンロードされてソース管理に置かれているものを開発者が特定できるよう支援するために作成されました。
Retire.jsはさまざまな方法で使用できます:
- コマンドラインスキャナとして
- Chrome拡張機能として - Chromeウェブストアでは公式には提供されていません
- Burp拡張機能として、またはZAPアドオンとして
- Firefox拡張機能として - Manifest V3の開発ビルド。インストール手順を参照してください。
- ヘッドレスWebサイトスキャナ
- gruntプラグインとして(非推奨)
- gulpタスクとして(非推奨)
コマンドラインスキャナ
WebアプリまたはNodeアプリをスキャンし、脆弱なJavaScriptライブラリやNode.JSモジュールの使用を検出します。まだインストールしていない場合は、まずnode/npmをインストールする必要があります。アプリケーションのソースコードフォルダで以下を実行します:
$ npm install -g retire
$ retire
SBOM の生成
retire.js は CycloneDX 形式で SBOM を生成できます:
$ retire --outputformat cyclonedx
cyclonedx は CycloneDX 1.4 XML を生成します。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 は、ペネトレーションテストツール Burp 用の プラグイン として Retire.js を適応させました。
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 は、Web サイトをヘッドレスモードでスキャンするために使用できます (chrome/firefox 拡張機能を使用するのとは対照的です)。
Grunt プラグイン (非推奨)
アプリケーションのビルドルーチンやその他の自動化ワークフローの一部として Retire.js を実行するための Grunt タスク です。
Gulp タスク (非推奨)
gulpfile で使用してプロジェクトファイルを自動的に監視およびスキャンできる Gulp タスクの例です。監視パターンと (オプションの) 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();
});
});
寄付
寄付は、ツールと脆弱性リポジトリの維持管理の資金として使用されます。
