
Быстрый (и безопасный) парсер для формата Windows XML Event Log (EVTX)
evtx читает журналы событий .evtx без Windows. Он поставляется как инструмент командной строки evtx_dump и как библиотека Rust. Привязки для Python находятся в 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"}
Что он делает:
--recover-records), а также извлекает чанки из образов дисков и других необработанных данных (--carve)..MTA экспортированного журнала (--mta) или из DLL провайдеров на машине (--messages).unsafe и работает везде, где работает стандартная библиотека Rust.evtx_dump для Windows, macOS или Linux (64-бит) со страницы релизов.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 перечисляет все параметры. Несколько вещей, которые стоит знать:
-t 1 использует один поток.--no-indent меняет только XML.--separate-json-attributes записывает "EventID": 6009, "EventID_attributes": {"Qualifiers": 32768}, тогда как по умолчанию записывается "EventID": {"#attributes": {"Qualifiers": 32768}, "#text": 6009}. Используйте его, когда поле должно сохранять один тип, например в Elasticsearch.info показывает версию, флаги dirty и full, номера записей и идентификаторы каждого чанка, а также совпадают ли CRC32. Это место, с которого стоит начать, если журнал выглядит неправильно.evtx_dump читает один журнал. Для папки остальное делает fd:
fd -e evtx -x evtx_dump -o jsonl выгружает каждый журнал в текущей папке в один поток JSON lines.fd -e evtx -x evtx_dump '{}' -f '{.}.xml' записывает XML-файл рядом с каждым журналом.xargs (gxargs в macOS) и jq: fd -a -e evtx | xargs -I input sh -c "evtx_dump -o jsonl input | jq --arg path "input" '. + {path: \$path}'"Очистка журнала сбрасывает его чанки, но оставляет в них старые записи. --recover-records читает и их, а также записи, оставшиеся в slack после последней записи чанка, и помечает каждую из них "recovered": true.
--carve предназначен для случаев, когда нет пригодного файла журнала. Он принимает любой файл (образ диска, нераспределённое пространство, дамп памяти, журнал, у которого отсутствует заголовок файла), разбирает каждый найденный чанк EVTX и пропускает точные копии чанка:
evtx_dump --carve -o jsonl unallocated.binevtx_dump --carve --recover-records -v -o jsonl disk.raw также читает slack каждого чанка и перечисляет, где был найден каждый чанк.Чанк содержит шаблоны и строки, необходимые его записям, поэтому записи извлекаются по одному чанку за раз. Запись, у которой перезаписан заголовок чанка, невозможно отобразить. В библиотеке evtx::carve::CarvedEvtx превращает источник в виртуальный файл EVTX для EvtxParser::from_read_seek.
.MTAЗапись содержит идентификатор события и его значения. Текст, который показывает для неё Event Viewer, находится не в журнале. Когда журнал сохраняется с информацией об отображении (Save All Events As в Event Viewer или wevtutil al), Windows записывает этот текст, а также имена уровня, задачи, кода операции и ключевых слов в LocaleMetaData\<log>_<LCID>.MTA рядом с .evtx. evtx_dump добавляет их к каждой записи как элемент RenderingInfo, подобный тому, что есть у пересылаемых событий:
evtx_dump --mta LocaleMetaData/Security_1033.MTA Security.evtxФайл .MTA должен быть тем, который был сохранён вместе с этим журналом. В библиотеке это ParserSettings::mta (см. модуль evtx::mta). docs/mta.md описывает формат файла и то, как Windows сопоставляет его строки событиям.
Без файла .MTA evtx_dump строит тот же RenderingInfo из собственных бинарных файлов поставщиков, скопированных с системы Windows: манифестов в их ресурсах WEVT_TEMPLATE и строк в их таблицах сообщений (в файлах .mui папки локали, например en-US). Вставки сообщения (%1, %2, ...) заполняются данными события.
evtx_dump --messages C:/copy/of/Windows/System32 Security.evtx--messages принимает папку или один бинарный файл и может быть указан более одного раза. --messages-locale выбирает другую папку локали. Используйте бинарные файлы машины, которая записала журнал: текст различается между сборками Windows. Отрисовка с сообщениями в несколько раз медленнее. В библиотеке это ParserSettings::messages с wevt_templates::messages::MessageCatalog.
Запись ссылается на шаблон, который обычно хранится в том же чанке. Если этот шаблон отсутствует или повреждён, запись не может быть отрисована. Те же шаблоны находятся в бинарном файле провайдера (EXE, DLL или SYS), и evtx_dump может собрать их в файл кэша и использовать его как запасной вариант.