
trabalho de mitigação do log4j
Este role Ansible implanta um script baseado em Python para mitigar programaticamente a vulnerabilidade Log4Shell (CVE-2021-44228), removendo a classe vulnerável JndiLookup dos arquivos JAR do Log4j afetados.
Ele foi projetado para ser executado via Ansible, mas você também pode executar o script manualmente, se desejar.
Saiba mais sobre a vulnerabilidade Log4Shell aqui:
.jar, .war e .ear nos diretórios de aplicação especificadosJndiLookup.class está presenteJndiLookup.class usando o zipfile do Python--apply, o script abre cada arquivo
em modo somente leitura e relata os que ainda contêm JndiLookup.class; nada é
copiado para backup ou reescrito. O role passa --apply a menos que
log4shell_apply: falsePyYAML, apenas para uma execução que lê um arquivo de configuração YAML (a
aplicação instalada). O role o instala a partir da distribuição (python3-yaml,
py3-yaml ou python3-pyyaml), nunca do PyPI. A entrada de detecção
precisa apenas da biblioteca padrão: sua configuração é passada como JSON no stdinNão é necessário zip ou zipinfo: os arquivos são lidos e reescritos com o
zipfile da biblioteca padrão, o que importa em imagens base de contêineres mínimas
onde nenhum dos dois está instalado.
O script é configurado via arquivo YAML, modelado automaticamente pelo role.
Exemplo de config.yaml:
app_directories:
- /opt/apps
backup_directory: /opt/backups
log_file: /var/log/log4j_mitigation.log
app_directories: lista de diretórios a serem verificados em busca de arquivos JARbackup_directory: onde armazenar os backups dos JARs originaislog_file: caminho para um arquivo de log para rastreamento de operaçõesAdicione este role ao seu playbook:
- name: Mitigate Log4Shell CVE-2021-44228
hosts: all
become: true
roles:
- log4shell_mitigation
Se você deseja executar o script manualmente, pode fazê-lo:
Copie o script e a biblioteca compartilhada ao lado dele para a sua máquina de destino:
files/log4shell_mitigator.py
files/samp_common.py
Crie seu próprio config.yaml no mesmo diretório.
Execute-o:
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 em
stdout. vulnerable conta os arquivos que ainda contêm JndiLookup.class;
already_stripped conta os arquivos log4j-core sem ele. Se
nested_needing_review ou unreadable for diferente de zero, esses arquivos não foram
avaliados e precisam de tratamento manual; o log nomeia cada um.0 nada mais contém a classe, 2 um arquivo ainda
a contém ou não pôde ser avaliado, 1 uma cópia de segurança ou reescrita falhou, 130
interrompido/var/log/log4j_mitigation.log) para ver quais JARs foram corrigidosEste repositório é um SAMP: o Microcelium Substrate o importa a partir desta URL exata, fixa-o por commit, verifica a assinatura da tag de release, escaneia-o e tem um humano aprová-lo antes de ser executado em qualquer lugar.
Manifesto. samp.yaml declara as CVEs, a quais hosts ele
se aplica, os pontos de entrada de detecção e aplicação, se cada um precisa de root,
as opções com seus padrões, cada caminho que uma aplicação escreve (touches),
cada programa que ele executa (commands) e as unidades que ele pode reiniciar. Um revisor
lê isso primeiro; o substrate verifica o código em relação a ele.
A detecção não escreve nada. tasks/detect.yml prepara o script e
samp_common.py em um diretório temporário privado, executa-o com a configuração
como JSON em stdin e o log em stdout, e remove o diretório. Nenhum
script é instalado, nenhuma configuração é templatizada, nenhum diretório de backup é criado, nenhum arquivo de log
é escrito e nenhum pacote é instalado. Ele também é executado sob ansible-playbook --check, porque apenas lê.
Aplicação. tasks/main.yml com log4shell_apply: true. Opções:
Nada é reiniciado ou recarregado a menos que a opção indique, e nada é jamais revertido: um downgrade reinstaura a vulnerabilidade.
Resultado. A última linha do script em stdout é
SAMP-RESULT {"format":1,"verdict":…,"counters":{…},"backups":[…],…},
após a linha de resumo humana key=N. O veredito é um de vulnerable,
no_fix, unknown, fixed (com "workaround":true quando uma solução alternativa,
e não um pacote corrigido, é o que está em vigor), not_affected ou failed.
Códigos de saída. 0 limpo (fixed, not_affected), 2 vulnerável ou
indecidido (vulnerable, no_fix, unknown: nunca limpo), 1 a execução
em si falhou, 130 interrompido.
Código compartilhado. log4shell_mitigation/files/samp_common.py é uma cópia byte a byte do
samp-common 1.0.3 (as comparações de versão dpkg, rpm e apk,
a linha de resultado, o carregamento de configuração). Seu sha256 está em
samp.yaml, e tests/test_samp_pack.py falha se a cópia diferir. Nunca
edite-o aqui; re-vendorize-o com o scripts/vendor.py do samp-common.
Releases são tags anotadas assinadas por SSH, samp/v<version> (esta:
samp/v1.0.3), assinadas com uma chave com suporte de hardware. O substrate
importa uma tag assinada, nunca um branch.
MIT
PRs e melhorias são bem-vindos -> faça um fork e envie um merge request.
Descubra as ferramentas mais usadas pela nossa comunidade.
Sem dados de popularidade ainda.