العودة إلى التحديثات
New releaseAug 21, 2026

retire.js v5.5.0

ماسح ضوئي يكتشف استخدام مكتبات جافا سكريبت ذات ثغرات أمنية معروفة. يمكنه أيضًا إنشاء قائمة مكونات برمجية (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 ملف 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 بتكييف 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();
  });
});

تبرع

ستُستخدم التبرعات لتمويل صيانة الأداة ومستودع الثغرات.

الفئات