
Um analisador rápido (e seguro) para o formato Windows XML Event Log (EVTX)
evtx lê logs de eventos .evtx sem o Windows. Ele vem como uma ferramenta de linha de comando, evtx_dump, e como uma biblioteca Rust. Os bindings para Python estão em pyevtx-rs (pip install evtx).
$ evtx_dump -o jsonl samples/security.evtx | jq -c 'select(.Event.System.EventID == 4720) | .Event.EventData | {SubjectUserName, TargetUserName}'
{"SubjectUserName":"WIN-03DLIIOFRRA$","TargetUserName":"fsir"}
{"SubjectUserName":"fsir","TargetUserName":"archir"}
O que ele faz:
--recover-records), e extrai chunks de imagens de disco e outros dados brutos (--carve)..MTA de um log exportado (--mta) ou das DLLs de provedor da máquina (--messages).unsafe, e funciona onde quer que a biblioteca padrão do Rust funcione.evtx_dump para Windows, macOS ou Linux (64 bits) na página de releases.cargo install evtx.evtx_dumpevtx_dump Security.evtx # XML, as Event Viewer shows it
evtx_dump -o jsonl Security.evtx # one JSON object per line
evtx_dump -o json Security.evtx # the same, with a "Record <id>" line before each
evtx_dump -o jsonl -f out.jsonl Security.evtx # to a file (asks before it overwrites one)
zcat Security.evtx.gz | evtx_dump -o jsonl - # from stdin
evtx_dump --events 100-200,950 Security.evtx # only these EventRecordIDs
evtx_dump info -i Security.evtx # the file and chunk headers, without parsing records
evtx_dump --help lista todas as opções. Alguns pontos que vale a pena conhecer:
-t 1 usa uma única thread.--no-indent altera apenas o XML.--separate-json-attributes grava "EventID": 6009, "EventID_attributes": {"Qualifiers": 32768} onde o padrão grava "EventID": {"#attributes": {"Qualifiers": 32768}, "#text": 6009}. Use-o quando um campo precisa manter um único tipo, por exemplo no Elasticsearch.info mostra a versão, os sinalizadores dirty e full, os números de registro e IDs de cada chunk, e se os CRC32s coincidem. É o ponto de partida com um log que parece errado.evtx_dump lê um log. Para uma pasta, o fd faz o resto:
fd -e evtx -x evtx_dump -o jsonl despeja todos os logs sob a pasta atual num único fluxo JSON lines.fd -e evtx -x evtx_dump '{}' -f '{.}.xml' grava um arquivo XML ao lado de cada log.xargs (gxargs no macOS) e jq: fd -a -e evtx | xargs -I input sh -c "evtx_dump -o jsonl input | jq --arg path "input" '. + {path: \$path}'"Limpar um log reinicia os seus chunks mas deixa os registros antigos neles. --recover-records lê também esses, e os registros deixados no slack após o último registro de um chunk, e marca cada um com "recovered": true.
--carve serve para quando não há um arquivo de log utilizável. Ele aceita qualquer arquivo (uma imagem de disco, espaço não alocado, um dump de memória, um log cujo cabeçalho de arquivo desapareceu), analisa cada chunk EVTX que encontra e ignora cópias exatas de um chunk:
evtx_dump --carve -o jsonl unallocated.binevtx_dump --carve --recover-records -v -o jsonl disk.raw lê também o slack de cada chunk, e lista onde cada chunk foi encontrado.Um chunk contém os templates e strings de que os seus registros precisam, por isso os registros são carved um chunk de cada vez. Um registro cujo cabeçalho de chunk foi sobrescrito não pode ser renderizado. Na biblioteca, evtx::carve::CarvedEvtx transforma uma origem num arquivo EVTX virtual para EvtxParser::from_read_seek.
.MTAUm registro contém um ID de evento e os seus valores. O texto que o Visualizador de Eventos mostra para ele não está no log. Quando um log é salvo com informações de exibição (Save All Events As do Visualizador de Eventos, ou wevtutil al), o Windows grava esse texto, e os nomes de nível, tarefa, opcode e palavra-chave, em LocaleMetaData\<log>_<LCID>.MTA ao lado do .evtx. evtx_dump adiciona-os a cada registro como um elemento RenderingInfo, como o que os eventos encaminhados têm:
evtx_dump --mta LocaleMetaData/Security_1033.MTA Security.evtxO arquivo .MTA deve ser o que foi salvo com esse log. Na biblioteca, isto é ParserSettings::mta (ver o módulo evtx::mta). docs/mta.md descreve o formato do arquivo e como o Windows associa as suas strings aos eventos.
Sem um arquivo .MTA, evtx_dump constrói o mesmo RenderingInfo a partir dos próprios binários dos provedores, copiados de um sistema Windows: os manifestos nos seus recursos WEVT_TEMPLATE, e as strings nas suas tabelas de mensagens (nos arquivos .mui de uma pasta de localidade como en-US). Os inserts da mensagem (%1, %2, ...) são preenchidos com os dados do evento.
evtx_dump --messages C:/copy/of/Windows/System32 Security.evtx--messages aceita uma pasta ou um único binário, e pode ser fornecido mais de uma vez. --messages-locale escolhe outra pasta de localidade. Use os binários da máquina que gravou o log: o texto difere entre builds do Windows. A renderização com mensagens é várias vezes mais lenta. Na biblioteca, isto é ParserSettings::messages com um wevt_templates::messages::MessageCatalog.
Um registro refere-se a um template, que normalmente é armazenado no mesmo chunk. Quando esse template está ausente ou danificado, o registro não pode ser renderizado. Os mesmos templates estão no binário do provedor (EXE, DLL ou SYS), e o evtx_dump pode coletá-los em um arquivo de cache e recorrer a ele.