لتحسين سرعة المسح، يبحث في نظام الملفات ويعالج فقط أسماء الملفات التالية:

• جميع الملفات ذات امتدادات ملفات Java ARchive في اسم الملف (أيضًا المتداخلة في هذه الأرشيفات):
  • *.jar, *.war, *.ear
• أسماء الملفات التي لدينا تجزئاتها المعروفة بالسيئة و الجيدة (أيضًا داخل الأرشيفات أعلاه، والمتداخلة):
  • JndiManager.class

إذا تطابق الملف مع أحد الامتدادات المذكورة أعلاه، فسيتحقق داخل هذه الأرشيفات (كلها في الذاكرة، لا شيء يتم فك ضغطه) للبحث عن أسماء الملفات التي لدى السكريبت تجزئات معروفة لها. كما يبحث داخل الأرشيفات المتداخلة، على سبيل المثال، ملف JAR داخل ملف WAR.

لا يقوم السكريبت بمسح امتدادات ملفات أرشيف أخرى مثل 7z, RAR, TAR, BZ2, إلخ. لذا، على سبيل المثال، إذا كان ملف JAR داخل ملف 7z، فلن يجده السكريبت. المنطق هو أن Java يمكنها تحميل تنسيقات Java ARchive فقط لذلك نقوم بمسح تلك فقط.

تظهر تجزئات MD5 غير المعروفة كـ UNKNOWN؛ قد يحدث هذا إذا استخدمت حزمة Java غير تابعة لـ log4j2 نفس اسم الملف الذي يبحث عنه هذا السكريبت. من المحتمل جدًا ألا يكون log4j2 إذا كان مسار الملف المحدد لا يحتوي على إشارات إلى org/apache/logging/log4j. ومع ذلك، لا يزال التحقق اليدوي موصى به.

التحميل والتشغيل

يمكنك تثبيت log4j-finder باستخدام إحدى الطرق التالية:

استخدام الملف الثنائي للإصدار

يمكنك تنزيل الملف الثنائي الصحيح لنظام التشغيل الخاص بك:

• أحدث إصدار لويندوز (موقع): log4j-finder-signed.exe
  • الملفات الثنائية غير الموقعة متاحة أيضًا ولكنها قد تؤدي إلى تشغيل برنامج مكافحة الفيروسات الخاص بك بسبب كونها ملفًا تنفيذيًا PyInstaller. يمكنك أيضًا إنشاء الملف التنفيذي بنفسك، راجع "إنشاء ملفات log4j-finder التنفيذية" لمعرفة كيفية القيام بذلك.
• أحدث إصدار للينكس x86_64: log4j-finder

إذا كنت على لينكس، يمكنك أيضًا تنزيل أحدث إصدار وتشغيله باستخدام إحدى الطرق التالية:

استخدام Python 3

للتوزيع مع تثبيت Python 3.6+، تعمل إحدى الطرق التالية أيضًا:

إنشاء ملفات log4j-finder التنفيذية

الملفات التنفيذية المولدة تلقائيًا

يوجد GitHub Action في المستودع يقوم تلقائيًا بإنشاء ملف ثنائي لويندوز ولينكس لسكريبت log4j-finder.py باستخدام PyInstaller في كل commit. تُستخدم نتائج بناء هذه العمليات لإرفاقها بصفحة الإصدارات.

نحن نعلم أن بعض موفري مضادات الفيروسات لا يحبون الملفات الثنائية لويندوز، في هذه الحالة نوصي بإنشاء الملف التنفيذي بنفسك باستخدام الخطوات التالية (لاحظ أننا نوفر الآن أيضًا ملفات ثنائية موقعة).

إنشاء الملف التنفيذي لويندوز

1. إذا لم يكن لديك Python 3.6 أو أعلى مثبتًا، قم بتنزيله أولاً من https://www.python.org/downloads/

   • اختر Python 3.8.10 إذا كنت تريد أن يعمل ملفك الثنائي على ويندوز 7:
     • تنزيل مثبت ويندوز لـ Python 3.8.10 (32 بت)
     • تنزيل مثبت ويندوز لـ Python 3.8.10 (64 بت)
   • تأكد من أنك أثناء التثبيت تختار: Add Python 3.x to PATH، فهذا يسهل الخطوات التالية.

2. افتح موجه الأوامر واستخدم pip لتثبيت حزمة pyinstaller:

   root@kitploit:~

   pip install pyinstaller
   
   # In the output you will see where pyinstaller is installed, for example:
   # C:\Users\User\AppData\Roaming\Python\Python310\Scripts
   #
   # Verify using --version
   C:\Users\User\AppData\Roaming\Python\Python310\Scripts\pyinstaller.exe --version
   4.7
   

3. اختياريًا، قم بتثبيت حزمة colorama لإضافة دعم للألوان:

   root@kitploit:~

   pip install colorama
   

4. قم بتنزيل أحدث إصدار من سكريبت log4j-finder.py ثم قم بتشغيل PyInstaller:

سيكون الملف التنفيذي لويندوز بعد ذلك في مجلد dist: dist\log4j-finder.exe

إنشاء الملف التنفيذي للينكس

مثال معطى لـ Debian 11:

الاستخدام

مثال استخدام لمسح مسار (الافتراضي هو /):

أو مباشرة ملف JAR:

أو أدلة متعددة و/أو ملفات:

استبعاد ملفات أو أدلة:

لاحظ أنه على ويندوز يقوم فقط بمسح محرك الأقراص الجذر c:\ إذا لم تعطِ أي وسائط إضافية. نوصي بتحديد محركات الأقراص التي تحتاج إلى مسحها في سطر الأوامر مثل (يتم تخطي محركات الأقراص غير الموجودة):

الملفات أو الأدلة التي لا يمكن الوصول إليها (أخطاء الرفض) لا تتم طباعتها.

إذا كنت تريد رؤية مخرجات أكثر، يمكنك إعطاء علامة -v للوضع المفصل، أو -vv لوضع التصحيح (موصى به فقط لأغراض التصحيح).

وسائط التطبيق:

يتم مسح الملفات بشكل متكرر، على القرص وفي ملفات أرشيف Java المتداخلة.