Um die Scan-Geschwindigkeit zu optimieren, durchsucht es das Dateisystem und verarbeitet NUR die folgenden Dateinamen:

• Alle Dateien mit Java ARchive-Dateierweiterungen im Dateinamen (auch verschachtelt in diesen Archiven):
  • *.jar, *.war, *.ear
• Dateinamen, für die wir bekannt schlechte und gute Hashes haben (auch innerhalb der obigen Archive und verschachtelt):
  • JndiManager.class

Wenn die Datei mit einer der oben genannten Erweiterungen übereinstimmt, wird in diesen Archiven (alles im Speicher, nichts wird entpackt) nach den Dateinamen gesucht, für die das Skript bekannte Hashes hat. Es sucht auch in verschachtelten Archiven, z. B. einer JAR-Datei in einer WAR-Datei.

Das Skript scannt KEINE anderen Archivdateierweiterungen wie 7z, RAR, TAR, BZ2 usw. Wenn sich also z. B. eine JAR-Datei in einer 7z-Datei befindet, wird das Skript sie nicht finden. Der Grund ist, dass Java nur Java ARchive-Formate laden kann, daher scannen wir nur diese.

Unbekannte MD5-Hashes werden als UNKNOWN angezeigt; dies kann passieren, wenn ein nicht zu log4j2 gehörendes Java-Paket denselben Dateinamen verwendet, nach dem dieses Skript sucht. Es ist höchstwahrscheinlich nicht log4j2, wenn der identifizierte Dateipfad keine Verweise auf org/apache/logging/log4j enthält. Dennoch wird eine manuelle Überprüfung empfohlen.

Herunterladen und Ausführen

Sie können log4j-finder mit einer der folgenden Methoden installieren:

Verwenden des Release-Binaries

Sie können das richtige Binary für Ihr Betriebssystem herunterladen:

• Windows aktuell (signiert): log4j-finder-signed.exe
  • Nicht signierte Binaries sind ebenfalls verfügbar, können aber Ihr Antivirenprogramm auslösen, da es sich um eine PyInstaller-ausführbare Datei handelt. Sie können die ausführbare Datei auch selbst erstellen, siehe „Generieren von log4j-finder-Executables“ für Anleitungen.
• Linux x86_64 aktuell: log4j-finder

Wenn Sie Linux verwenden, können Sie das neueste Release auch auf eine der folgenden Arten herunterladen und ausführen:

Verwendung von Python 3

Für Distributionen mit installiertem Python 3.6+ funktionieren auch die folgenden Methoden:

Generieren von log4j-finder-Executables

Automatisch generierte Executables

Im Repository gibt es eine GitHub Action, die bei jedem Commit automatisch ein Windows- und Linux-Binary des Skripts log4j-finder.py mit PyInstaller erstellt. Die Build-Artefakte dieser Workflow-Läufe werden verwendet, um sie an die Releases-Seite anzuhängen.

Wir sind uns bewusst, dass einige Antivirenanbieter die Windows-Binaries nicht mögen. In diesem Fall empfehlen wir, die ausführbare Datei selbst mit den folgenden Schritten zu erstellen (beachten Sie, dass wir jetzt auch signierte Binaries bereitstellen).

Generieren des Windows-Executables

1. Wenn Sie Python 3.6 oder höher nicht installiert haben, laden Sie es zunächst von https://www.python.org/downloads/ herunter.

   • Wählen Sie Python 3.8.10, wenn Ihr Binary unter Windows 7 funktionieren soll:
     • Herunterladen Python 3.8.10 Windows-Installer (32-Bit)
     • Herunterladen Python 3.8.10 Windows-Installer (64-Bit)
   • Stellen Sie sicher, dass Sie während der Installation Add Python 3.x to PATH auswählen, das erleichtert die folgenden Schritte erheblich.

2. Öffnen Sie eine Eingabeaufforderung und verwenden Sie pip, um das Paket pyinstaller zu installieren:

   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. Optional können Sie das Paket colorama installieren, um Farbunterstützung hinzuzufügen:

   root@kitploit:~

   pip install colorama
   

4. Laden Sie die neueste Version des Skripts log4j-finder.py herunter und führen Sie dann PyInstaller aus:

Das Windows-Executable befindet sich dann im Verzeichnis dist: dist\log4j-finder.exe

Generieren des Linux-Executables

Beispiel für Debian 11:

Verwendung

Beispiel zur Verwendung zum Scannen eines Pfads (Standard: /):

Oder direkt eine JAR-Datei:

Oder mehrere Verzeichnisse und/oder Dateien:

Ausschließen von Dateien oder Verzeichnissen:

Beachten Sie, dass es unter Windows nur das Stammverzeichnis c:\ scannt, wenn Sie keine zusätzlichen Argumente angeben. Wir empfehlen, die zu scannenden Laufwerke in der Befehlszeile anzugeben, z. B. (nicht vorhandene Laufwerke werden übersprungen):

Dateien oder Verzeichnisse, auf die nicht zugegriffen werden kann (Permission denied-Fehler), werden nicht ausgegeben.

Wenn Sie mehr Ausgabe sehen möchten, können Sie das -v-Flag für ausführliche Ausgabe oder -vv für den Debug-Modus verwenden (nur zu Debugging-Zwecken empfohlen).

Anwendungsargumente:

Dateien werden rekursiv gescannt, sowohl auf der Festplatte als auch in (verschachtelten) Java-Archivdateien.