
Log4j-Mitigationsarbeit
Diese Ansible-Rolle stellt ein Python-basiertes Skript bereit, um die Log4Shell-Schwachstelle (CVE-2021-44228) programmatisch zu entschärfen, indem die verwundbare JndiLookup-Klasse aus betroffenen Log4j-JAR-Dateien entfernt wird.
Sie ist für die Ausführung über Ansible konzipiert, das Skript kann jedoch auch manuell ausgeführt werden.
Weitere Informationen zur Log4Shell-Schwachstelle finden Sie hier:
.jar-, .war- und .ear-Dateien in angegebenen AnwendungsverzeichnissenJndiLookup.class vorhanden istJndiLookup.class mithilfe von Pythons zipfile--apply öffnet das Skript jedes Archiv
schreibgeschützt und meldet diejenigen, die noch JndiLookup.class enthalten;
es wird nichts gesichert oder neu geschrieben. Die Rolle übergibt --apply,
sofern nicht log4shell_apply: false gesetzt istPyYAML, nur für einen Lauf, der eine YAML-Konfigurationsdatei liest (die
installierte Apply-Variante). Die Rolle installiert es aus der Distribution
(python3-yaml, py3-yaml oder python3-pyyaml), niemals von PyPI. Der
Detection-Einstiegspunkt benötigt nur die Standardbibliothek: seine Konfiguration
wird als JSON über stdin übergebenzip oder zipinfo werden nicht benötigt: Archive werden mit der
Standardbibliothek zipfile gelesen und neu geschrieben, was auf minimalen
Container-Basisimages wichtig ist, auf denen keines von beiden installiert ist.
Das Skript wird über eine YAML-Datei konfiguriert, die von der Rolle automatisch als Template erzeugt wird.
Beispiel config.yaml:
app_directories:
- /opt/apps
backup_directory: /opt/backups
log_file: /var/log/log4j_mitigation.log
app_directories: Liste der Verzeichnisse, die nach JAR-Dateien durchsucht werden sollenbackup_directory: Verzeichnis, in dem die Backups der ursprünglichen JAR-Dateien gespeichert werdenlog_file: Pfad zu einer Protokolldatei zur Nachverfolgung der VorgängeFügen Sie diese Rolle zu Ihrem Playbook hinzu:
- name: Mitigate Log4Shell CVE-2021-44228
hosts: all
become: true
roles:
- log4shell_mitigation
Wenn Sie das Skript manuell ausführen möchten, können Sie dies folgendermaßen tun:
Kopieren Sie das Skript und die daneben liegende gemeinsame Bibliothek auf Ihren Zielrechner:
files/log4shell_mitigator.py
files/samp_common.py
Erstellen Sie Ihre eigene config.yaml im selben Verzeichnis.
Führen Sie es aus:
python3 log4shell_mitigator.py # dry run, config.yaml beside the script
python3 log4shell_mitigator.py --config /path/to/config.yaml
sudo python3 log4shell_mitigator.py --apply # back up and rewrite
scanned=N vulnerable=N patched=N already_stripped=N unreadable=N failed=N nested_needing_review=N dry_run=N auf
stdout aus. vulnerable zählt Archive, die noch JndiLookup.class enthalten;
already_stripped zählt log4j-core-Archive ohne diese Klasse. Wenn
nested_needing_review oder unreadable ungleich null ist, wurden diese Archive nicht
bewertet und müssen manuell behandelt werden; das Log benennt jedes einzelne.0 nichts trägt die Klasse mehr, 2 ein Archiv trägt sie noch
oder konnte nicht bewertet werden, 1 ein Backup oder Überschreiben ist fehlgeschlagen, 130
unterbrochen/var/log/log4j_mitigation.log), um zu sehen, welche JARs gepatcht wurdenDieses Repository ist ein SAMP: Die Microcelium Substrate importiert es von genau dieser URL, pinnt es per Commit, verifiziert die Signatur des Release-Tags, scannt es und lässt es von einem Menschen freigeben, bevor es irgendwo ausgeführt wird.
samp.yaml deklariert die CVEs, auf welche Hosts es
angewendet wird, die Einstiegspunkte für Erkennung und Anwendung, ob jeweils Root erforderlich ist,
die Optionen mit ihren Standardwerten, jeden Pfad, den eine Anwendung schreibt (touches),
jedes Programm, das sie ausführt (commands), und die Units, die sie neu starten darf. Ein Reviewer
liest es zuerst; das Substrate prüft den Code dagegen.tasks/detect.yml legt das Skript und
samp_common.py in einem privaten temporären Verzeichnis ab, führt es mit der Konfiguration
als JSON auf stdin und dem Log auf stdout aus und entfernt das Verzeichnis. Es
wird kein Skript installiert, keine Konfiguration aus Templates erzeugt, kein Backup-Verzeichnis angelegt, keine Logdatei
geschrieben und kein Paket installiert. Es läuft auch unter ansible-playbook --check, da es nur liest.tasks/main.yml mit log4shell_apply: true. Optionen: