
Ein schneller (und sicherer) Parser für das Windows XML Event Log (EVTX)-Format
evtx liest .evtx-Ereignisprotokolle ohne Windows. Es ist als Kommandozeilenwerkzeug evtx_dump und als Rust-Bibliothek verfügbar. Python-Bindings befinden sich in 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"}
Was es tut:
--recover-records) und extrahiert Chunks aus Datenträgerabbildern und anderen Rohdaten (--carve)..MTA-Datei eines exportierten Logs (--mta) oder aus den Provider-DLLs des Systems (--messages).unsafe-Code und läuft überall dort, wo Rusts Standardbibliothek läuft.evtx_dump für Windows, macOS oder Linux (64-Bit) von der Releases-Seite herunter.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 listet jede Option auf. Ein paar Dinge, die man wissen sollte:
-t 1 verwendet einen einzelnen Thread.--no-indent ändert nur XML.--separate-json-attributes schreibt "EventID": 6009, "EventID_attributes": {"Qualifiers": 32768}, wo der Standard "EventID": {"#attributes": {"Qualifiers": 32768}, "#text": 6009} schreibt. Verwende es, wenn ein Feld einen Typ beibehalten muss, zum Beispiel in Elasticsearch.info zeigt die Version, die Flags dirty und full, die Datensatznummern und IDs jedes Chunks und ob die CRC32s übereinstimmen. Es ist der Ausgangspunkt bei einem Log, das falsch aussieht.evtx_dump liest ein Log. Für einen Ordner erledigt fd den Rest:
fd -e evtx -x evtx_dump -o jsonl gibt jedes Log unter dem aktuellen Ordner in einen JSON-Lines-Stream aus.fd -e evtx -x evtx_dump '{}' -f '{.}.xml' schreibt eine XML-Datei neben jedes Log.xargs (gxargs unter macOS) und jq: fd -a -e evtx | xargs -I input sh -c "evtx_dump -o jsonl input | jq --arg path "input" '. + {path: \$path}'"Das Leeren eines Logs setzt seine Chunks zurück, lässt aber die alten Datensätze darin stehen. --recover-records liest auch diese, sowie die Datensätze, die im Slack nach dem letzten Datensatz eines Chunks verbleiben, und markiert jeden mit "recovered": true.
--carve ist für den Fall, dass keine brauchbare Logdatei vorhanden ist. Es nimmt eine beliebige Datei (ein Disk-Image, nicht zugeordneten Speicherplatz, einen Speicherauszug, ein Log, dessen Dateiheader fehlt), parst jeden gefundenen EVTX-Chunk und überspringt exakte Kopien eines Chunks:
evtx_dump --carve -o jsonl unallocated.binevtx_dump --carve --recover-records -v -o jsonl disk.raw liest zusätzlich den Slack jedes Chunks und listet auf, wo jeder Chunk gefunden wurde.Ein Chunk enthält die Vorlagen und Zeichenketten, die seine Datensätze benötigen, daher werden Datensätze Chunk für Chunk gecarvt. Ein Datensatz, dessen Chunk-Header überschrieben wurde, kann nicht gerendert werden. In der Bibliothek verwandelt evtx::carve::CarvedEvtx eine Quelle in eine virtuelle EVTX-Datei für EvtxParser::from_read_seek.
.MTA-DateienEin Datensatz enthält eine Ereignis-ID und ihre Werte. Der Text, den die Ereignisanzeige dafür anzeigt, steht nicht im Log. Wenn ein Log mit Anzeigeinformationen gespeichert wird (über Alle Ereignisse speichern unter in der Ereignisanzeige oder wevtutil al), schreibt Windows diesen Text sowie die Namen von Level, Task, Opcode und Keyword in LocaleMetaData\<log>_<LCID>.MTA neben die .evtx. evtx_dump fügt sie jedem Datensatz als RenderingInfo-Element hinzu, wie es weitergeleitete Ereignisse haben:
evtx_dump --mta LocaleMetaData/Security_1033.MTA Security.evtxDie .MTA-Datei muss diejenige sein, die mit diesem Log gespeichert wurde. In der Bibliothek ist dies ParserSettings::mta (siehe das Modul evtx::mta). docs/mta.md beschreibt das Dateiformat und wie Windows seine Zeichenketten den Ereignissen zuordnet.
Ohne eine .MTA-Datei baut evtx_dump dasselbe RenderingInfo aus den Binärdateien der Provider selbst, kopiert von einem Windows-System: die Manifeste in ihren WEVT_TEMPLATE-Ressourcen und die Zeichenketten in ihren Nachrichtentabellen (in den .mui-Dateien eines Locale-Ordners wie en-US). Die Platzhalter der Meldung (%1, %2, ...) werden mit den Daten des Ereignisses gefüllt.
evtx_dump --messages C:/copy/of/Windows/System32 Security.evtx--messages nimmt einen Ordner oder eine einzelne Binärdatei entgegen und kann mehrfach angegeben werden. --messages-locale wählt einen anderen Locale-Ordner. Verwende die Binärdateien der Maschine, die das Log geschrieben hat: Der Text unterscheidet sich zwischen Windows-Builds. Das Rendern mit Meldungen ist mehrere Male langsamer. In der Bibliothek ist dies ParserSettings::messages mit einem wevt_templates::messages::MessageCatalog.