
Lavoro di mitigazione di log4j
Questo ruolo Ansible distribuisce uno script basato su Python per mitigare programmaticamente la vulnerabilità Log4Shell (CVE-2021-44228) rimuovendo la classe vulnerabile JndiLookup dai file JAR di Log4j interessati.
È progettato per essere eseguito tramite Ansible, ma puoi anche eseguire lo script manualmente se lo desideri.
Maggiori informazioni sulla vulnerabilità Log4Shell qui:
.jar, .war e .ear nelle directory applicative specificateJndiLookup.class è presenteJndiLookup.class usando il modulo zipfile di Python--apply lo script apre ogni archivio
in sola lettura e segnala quelli che contengono ancora JndiLookup.class; nulla viene
sottoposto a backup o riscritto. Il ruolo passa --apply a meno che
log4shell_apply: falsePyYAML, solo per un'esecuzione che legge un file di configurazione YAML (l'apply
installato). Il ruolo lo installa dalla distribuzione (python3-yaml,
py3-yaml o python3-pyyaml), mai da PyPI. La voce di rilevamento
necessita solo della libreria standard: la sua configurazione viene passata come JSON su stdinNon sono necessari zip o zipinfo: gli archivi vengono letti e riscritti con
il modulo zipfile della libreria standard, il che è importante sulle immagini base container minimali
dove nessuno dei due è installato.
Lo script è configurato tramite un file YAML, templatizzato automaticamente dal ruolo.
Esempio di config.yaml:
app_directories:
- /opt/apps
backup_directory: /opt/backups
log_file: /var/log/log4j_mitigation.log
app_directories: elenco delle directory in cui cercare i file JARbackup_directory: dove archiviare i backup dei JAR originalilog_file: percorso di un file di log per il tracciamento delle operazioniAggiungi questo ruolo al tuo playbook:
- name: Mitigate Log4Shell CVE-2021-44228
hosts: all
become: true
roles:
- log4shell_mitigation
Se desideri eseguire lo script manualmente, puoi farlo:
Copia lo script e la libreria condivisa accanto ad esso sulla macchina di destinazione:
files/log4shell_mitigator.py
files/samp_common.py
Crea il tuo config.yaml nella stessa directory.
Esegui:
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 su
stdout. vulnerable conta gli archivi che contengono ancora JndiLookup.class;
already_stripped conta gli archivi log4j-core che ne sono privi. Se
nested_needing_review o unreadable è diverso da zero, quegli archivi non sono stati
valutati e richiedono una gestione manuale; il log ne riporta il nome di ciascuno.0 nessun archivio contiene più la classe, 2 un archivio la
contiene ancora o non è stato possibile valutarlo, 1 un backup o una riscrittura è fallito, 130
interrotto/var/log/log4j_mitigation.log) per vedere quali JAR sono stati correttiQuesto repository è un SAMP: il Microcelium Substrate lo importa da questo esatto URL, lo fissa per commit, verifica la firma del tag di release, lo analizza e fa sì che una persona lo approvi prima che venga eseguito ovunque.
Manifest. samp.yaml dichiara le CVE, gli host a cui
si applica, i punti di ingresso di rilevamento e applicazione, se ciascuno richiede root,
le opzioni con i loro valori predefiniti, ogni percorso che un'apply scrive (touches),
ogni programma che esegue (commands) e le unit che può riavviare. Un revisore
lo legge per primo; il substrate verifica il codice rispetto ad esso.
Il rilevamento non scrive nulla. tasks/detect.yml colloca lo script e
samp_common.py in una directory temporanea privata, lo esegue con la configurazione
come JSON su stdin e il log su stdout, e rimuove la directory. Nessuno
script viene installato, nessuna configurazione templatizzata, nessuna directory di backup creata, nessun file di log
scritto e nessun pacchetto installato. Viene eseguito anche con ansible-playbook --check, perché legge soltanto.
Apply. tasks/main.yml con log4shell_apply: true. Opzioni:
Nulla viene riavviato o ricaricato a meno che l'opzione non lo indichi, e nulla viene mai ripristinato: un downgrade reintroduce la vulnerabilità.
Risultato. L'ultima riga dello script su stdout è
SAMP-RESULT {"format":1,"verdict":…,"counters":{…},"backups":[…],…},
dopo la riga di riepilogo umana key=N. Il verdetto è uno tra vulnerable,
no_fix, unknown, fixed (con "workaround":true quando ciò che è in vigore è una workaround,
non un pacchetto corretto), not_affected, o failed.
Codici di uscita. 0 pulito (fixed, not_affected), 2 vulnerabile o
indeciso (vulnerable, no_fix, unknown: mai pulito), 1 l'esecuzione
stessa è fallita, 130 interrotto.
Codice condiviso. log4shell_mitigation/files/samp_common.py è una copia byte per byte di
samp-common 1.0.3 (i confronti di versione dpkg, rpm e apk,
la riga di risultato, il caricamento della configurazione). Il suo sha256 è in
samp.yaml, e tests/test_samp_pack.py fallisce se la copia differisce. Non
modificarlo qui; rieseguine il vendor con scripts/vendor.py di samp-common.
Le release sono tag annotati firmati via SSH, samp/v<version> (questa:
samp/v1.0.3), firmati con una chiave supportata da hardware. Il substrate
importa un tag firmato, mai un branch.
MIT