
trabajo de mitigación de log4j
Este rol de Ansible despliega un script basado en Python para mitigar programáticamente la vulnerabilidad Log4Shell (CVE-2021-44228) eliminando la clase vulnerable JndiLookup de los archivos JAR de Log4j afectados.
Está diseñado para ejecutarse mediante Ansible, pero también puedes ejecutar el script manualmente si lo deseas.
Lee más sobre la vulnerabilidad Log4Shell aquí:
.jar, .war y .ear en los directorios de aplicación especificadosJndiLookup.class está presenteJndiLookup.class usando el módulo zipfile de Python--apply el script abre cada archivo en
modo de solo lectura y reporta los que aún contienen JndiLookup.class; no se
realiza ninguna copia de seguridad ni reescritura. El rol pasa --apply a menos que
log4shell_apply: falsePyYAML, solo para una ejecución que lea un archivo de configuración YAML (la
aplicación instalada). El rol lo instala desde la distribución (python3-yaml,
py3-yaml o python3-pyyaml), nunca desde PyPI. La entrada de detección
solo necesita la biblioteca estándar: su configuración se pasa como JSON por stdinNo se necesita zip ni zipinfo: los archivos se leen y reescriben con el
módulo zipfile de la biblioteca estándar, lo cual es importante en imágenes base de contenedores mínimas
donde ninguno de los dos está instalado.
El script se configura mediante un archivo YAML, que el rol genera automáticamente a partir de una plantilla.
Ejemplo de config.yaml:
app_directories:
- /opt/apps
backup_directory: /opt/backups
log_file: /var/log/log4j_mitigation.log
app_directories: lista de directorios donde buscar archivos JARbackup_directory: dónde almacenar las copias de seguridad de los JAR originaleslog_file: ruta a un archivo de registro para el seguimiento de operacionesAñade este rol a tu playbook:
- name: Mitigate Log4Shell CVE-2021-44228
hosts: all
become: true
roles:
- log4shell_mitigation
Si deseas ejecutar el script manualmente, puedes hacerlo:
Copia el script y la biblioteca compartida junto a él a tu máquina de destino:
files/log4shell_mitigator.py
files/samp_common.py
Crea tu propio config.yaml en el mismo directorio.
Ejecútalo:
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 en
stdout. vulnerable cuenta los archivos que aún contienen JndiLookup.class;
already_stripped cuenta los archivos log4j-core que no lo contienen. Si
nested_needing_review o unreadable no es cero, esos archivos no fueron
evaluados y requieren manejo manual; el log nombra cada uno.0 no queda nada que contenga la clase, 2 un archivo aún
la contiene o no pudo ser evaluado, 1 falló una copia de seguridad o una reescritura, 130
interrumpido/var/log/log4j_mitigation.log) para ver qué JARs fueron parcheadosEste repositorio es un SAMP: el Microcelium Substrate lo importa desde esta URL exacta, lo fija por commit, verifica la firma de la etiqueta de release, lo escanea y hace que un humano lo apruebe antes de que se ejecute en cualquier lugar.
Manifiesto. samp.yaml declara los CVE, a qué hosts
aplica, los puntos de entrada de detección y aplicación, si cada uno necesita root,
las opciones con sus valores por defecto, cada ruta que escribe una aplicación (touches),
cada programa que ejecuta (commands) y las unidades que puede reiniciar. Un revisor
lo lee primero; el substrate verifica el código contra él.
La detección no escribe nada. tasks/detect.yml prepara el script y
samp_common.py en un directorio temporal privado, lo ejecuta con la configuración
como JSON en stdin y el log en stdout, y elimina el directorio. No
se instala ningún script, no se genera ninguna configuración a partir de plantilla, no se crea ningún directorio de copias de seguridad, no se escribe ningún archivo
de log y no se instala ningún paquete. También se ejecuta bajo ansible-playbook --check, porque solo lee.
Aplicación. tasks/main.yml con log4shell_apply: true. Opciones:
Nada se reinicia ni se recarga a menos que la opción lo indique, y nada se revierte jamás: una degradación reinstaura la vulnerabilidad.
Resultado. La última línea del script en stdout es
SAMP-RESULT {"format":1,"verdict":…,"counters":{…},"backups":[…],…},
después de la línea de resumen humana key=N. El veredicto es uno de vulnerable,
no_fix, unknown, fixed (con "workaround":true cuando lo que está en efecto es un workaround,
no un paquete corregido), not_affected, o failed.
Códigos de salida. 0 limpio (fixed, not_affected), 2 vulnerable o
indeciso (vulnerable, no_fix, unknown: nunca limpio), 1 la ejecución
en sí falló, 130 interrumpido.
Código compartido. log4shell_mitigation/files/samp_common.py es una copia byte a byte de
samp-common 1.0.3 (las comparaciones de versiones de dpkg, rpm y apk,
la línea de resultado, la carga de configuración). Su sha256 está en
samp.yaml, y tests/test_samp_pack.py falla si la copia difiere. Nunca
lo edite aquí; vuelva a incluirlo con scripts/vendor.py de samp-common.
Las releases son etiquetas anotadas firmadas por SSH, samp/v<version> (esta:
samp/v1.0.3), firmadas con una clave respaldada por hardware. El substrate
importa una etiqueta firmada, nunca una rama.
MIT