Skip to content
KitploitKITPLOIT
도구익스플로잇블로그
Log in
제출
도구익스플로잇블로그
제출

해킹, 침투 테스트 및 사이버 보안 도구를 당신의 보안 무기고에!

Kitploit은 해킹, 사이버 보안 및 침투 테스트 도구 디렉토리입니다. 최신 프로젝트 업데이트를 발견하여 취약점을 찾고, 시스템을 분석하고, 테스트를 자동화하고, 보안을 강화하세요.

피드문의개인정보© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
evtx — Windows XML Event Log (EVTX) 형식을 위한 빠르고 (안전한) 파서 | Kitploit
도구/GitHubGitHub/omerbenamram/evtx
ForensicsDigital ForensicsIncident ResponseLog Analysis
GitHubomerbenamram/evtx

evtx

Windows XML Event Log (EVTX) 형식을 위한 빠르고 (안전한) 파서

저장소 보기
94981625일 전Kitploit 검토 완료
공유

EVTX

모든 플랫폼에서 사용할 수 있는 Windows XML 이벤트 로그(EVTX) 형식 파서

Crates.io version Downloads docs.rs docs safety-dance Build status

evtx는 Windows 없이도 .evtx 이벤트 로그를 읽습니다. 명령줄 도구인 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"}

기능:

  • 각 레코드를 XML 또는 JSON으로 작성합니다. 둘 다 동일한 파싱된 레코드로부터 생성되며, 하나를 다른 하나로 변환하는 방식이 아닙니다.
  • 모든 코어에서 파싱합니다. 30 MB 로그는 8개 스레드에서 약 20 ms, 1개 스레드에서 약 75 ms가 소요됩니다(성능 참조).
  • 손상되고 지저분한 로그도 레코드 단위로 읽으며, 읽지 못한 부분을 알려줍니다.
  • 청크 슬랙과 지워진 청크에서 오래된 레코드를 복구하고(--recover-records), 디스크 이미지 및 기타 원시 데이터에서 청크를 추출합니다(--carve).
  • 내보낸 로그의 .MTA 파일(--mta) 또는 머신의 공급자 DLL(--messages)에서 Event Viewer가 표시하는 메시지 텍스트를 추가합니다.
  • unsafe 코드가 없으며, Rust 표준 라이브러리가 동작하는 모든 곳에서 실행됩니다.

설치

  • 릴리스 페이지에서 Windows, macOS 또는 Linux(64비트)용 evtx_dump를 다운로드하세요.
  • 또는 직접 빌드하세요: cargo install evtx.

evtx_dump

evtx_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는 모든 옵션을 나열합니다. 몇 가지 알아둘 만한 점이 있습니다:

  • 레코드는 stdout으로, 오류는 stderr로 출력됩니다. 읽을 수 없는 레코드나 청크는 보고된 후 건너뛰며, 이때 종료 상태는 3이 됩니다. 상태 1은 실행이 시작되지 못했거나 중단되어야 했음을 의미합니다.
  • 청크는 코어당 하나의 스레드로 파싱되며, 레코드는 여전히 파일 순서대로 출력됩니다. -t 1은 단일 스레드를 사용합니다.
  • JSON 출력은 항상 압축 형식입니다. --no-indent는 XML에만 영향을 줍니다.
  • --separate-json-attributes는 기본값이 "EventID": {"#attributes": {"Qualifiers": 32768}, "#text": 6009}를 출력하는 곳에 "EventID": 6009, "EventID_attributes": {"Qualifiers": 32768}를 출력합니다. 필드가 하나의 타입을 유지해야 할 때, 예를 들어 Elasticsearch에서 사용하십시오.
  • info는 버전, dirty 및 full 플래그, 각 청크의 레코드 번호와 ID, 그리고 CRC32가 일치하는지 여부를 보여줍니다. 이상해 보이는 로그를 다룰 때 시작할 지점입니다.

여러 파일

evtx_dump는 하나의 로그를 읽습니다. 폴더의 경우 fd가 나머지를 처리합니다:

  • fd -e evtx -x evtx_dump -o jsonl은 현재 폴더 아래의 모든 로그를 하나의 JSON lines 스트림으로 덤프합니다.
  • fd -e evtx -x evtx_dump '{}' -f '{.}.xml'은 각 로그 옆에 XML 파일을 작성합니다.
  • 각 레코드의 원본 파일을 JSON에 추가하려면 xargs(macOS에서는 gxargs)와 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.bin
  • evtx_dump --carve --recover-records -v -o jsonl disk.raw는 각 청크의 slack도 읽고, 각 청크가 발견된 위치를 나열합니다.

청크는 해당 레코드에 필요한 템플릿과 문자열을 담고 있으므로, 레코드는 청크 단위로 카빙됩니다. 청크 헤더가 덮어써진 레코드는 렌더링할 수 없습니다. 라이브러리에서는 evtx::carve::CarvedEvtx가 소스를 EvtxParser::from_read_seek용 가상 EVTX 파일로 변환합니다.

.MTA 파일의 메시지 텍스트

레코드는 이벤트 ID와 그 값들을 담고 있습니다. 이벤트 뷰어가 표시하는 텍스트는 로그에 없습니다. 로그가 표시 정보와 함께 저장될 때(이벤트 뷰어의 Save All Events As 또는 wevtutil al), Windows는 그 텍스트와 수준, 작업, opcode 및 키워드 이름을 .evtx 옆의 LocaleMetaData\<log>_<LCID>.MTA에 기록합니다. evtx_dump는 이를 전달된 이벤트가 가지는 것과 같은 RenderingInfo 요소로 각 레코드에 추가합니다:

  • evtx_dump --mta LocaleMetaData/Security_1033.MTA Security.evtx

.MTA 파일은 해당 로그와 함께 저장된 것이어야 합니다. 라이브러리에서는 이것이 ParserSettings::mta입니다(evtx::mta 모듈 참조). docs/mta.md는 파일 형식과 Windows가 그 문자열을 이벤트에 매칭하는 방법을 설명합니다.

공급자 바이너리의 메시지 텍스트

.MTA 파일이 없으면, evtx_dump는 Windows 시스템에서 복사한 공급자 자체 바이너리로부터 동일한 RenderingInfo를 구성합니다: WEVT_TEMPLATE 리소스의 매니페스트와, 로캘 폴더(예: en-US)의 .mui 파일에 있는 메시지 테이블의 문자열입니다. 메시지의 삽입 자리(%1, %2, ...)는 이벤트의 데이터로 채워집니다.

  • evtx_dump --messages C:/copy/of/Windows/System32 Security.evtx

--messages는 폴더 또는 단일 바이너리를 받으며, 여러 번 지정할 수 있습니다. --messages-locale은 다른 로캘 폴더를 선택합니다. 로그를 기록한 머신의 바이너리를 사용하십시오: 텍스트는 Windows 빌드마다 다릅니다. 메시지로 렌더링하는 것은 몇 배 더 느립니다. 라이브러리에서는 이것이 wevt_templates::messages::MessageCatalog와 함께 쓰이는 ParserSettings::messages입니다.

템플릿이 없는 레코드 (WEVT_TEMPLATE 캐시)

레코드는 일반적으로 동일한 청크에 저장된 템플릿을 참조합니다. 해당 템플릿이 없거나 손상된 경우 레코드를 렌더링할 수 없습니다. 동일한 템플릿이 공급자의 바이너리(EXE, DLL 또는 SYS)에 있으며, evtx_dump는 이를 캐시 파일로 수집하여 대체(fallback)로 사용할 수 있습니다.

  • 캐시 구축, 단일 .wevtcache 파일: evtx_dump extract-wevt-templates --input <provider.dll> --output /tmp/wevt_cache.wevtcache --overwrite
  • 사용법: evtx_dump --wevt-cache /tmp/wevt_cache.wevtcache <log.evtx>. 캐시는 템플릿 GUID가 없거나 손상되어 실패한 레코드에 대해서만 조회되므로, 정상적인 로그의 출력은 변경되지 않습니다.

이를 디버깅할 때 도움이 되는 두 가지 명령이 있습니다:

  • evtx_dump dump-template-instances --input <log.evtx> --record-id <ID>는 레코드의 템플릿 인스턴스에 대한 대체 값을 JSON 라인으로 출력합니다. 첫 번째 인스턴스는 System을 채우며, 두 번째는 보통 공급자 자체의 템플릿입니다.
  • evtx_dump apply-wevt-cache --cache /tmp/wevt_cache.wevtcache --template-guid <GUID> --evtx <log.evtx> --record-id <ID>는 레코드의 값으로 하나의 템플릿을 XML로 렌더링합니다.

docs/wevt_templates.md에 세부 사항과 배경(이슈 #103)이 있습니다.

브라우저에서

EVTX Web Screenshot

https://omerbenamram.github.io/evtx/는 동일한 파서를 기반으로 구축되어 WebAssembly로 컴파일된 뷰어입니다. .evtx 파일을 페이지에 끌어다 놓으세요. 파일은 브라우저에서 파싱되며 어디에도 업로드되지 않고, 첫 로드 이후에는 페이지가 오프라인으로 작동합니다.

레벨, 공급자, 채널, 이벤트 ID 및 EventData 필드에 대한 필터(DuckDB-WASM으로 실행), 전체 텍스트 검색, 열 선택, 필터링된 이벤트의 JSON 또는 XML 내보내기를 제공합니다. 화면에 표시되는 행만 렌더링하여 대용량 로그를 처리합니다.

라이브러리로

use evtx::EvtxParser;
use std::path::PathBuf;

// Change this to a path of your .evtx sample.
let fp = PathBuf::from(format!("{}/samples/security.evtx", std::env::var("CARGO_MANIFEST_DIR").unwrap()));

let mut parser = EvtxParser::from_path(fp).unwrap();
for record in parser.records() {
    match record {
        Ok(r) => println!("Record {}\n{}", r.event_record_id, r.data),
        Err(e) => eprintln!("{}", e),
    }
}

records()는 XML을, records_json()은 JSON 문자열을, records_json_value()는 serde_json::Value를 반환합니다. 각 항목은 Result이므로 손상된 레코드 하나가 반복을 끝내지 않습니다. ParserSettings에는 evtx_dump가 플래그로 제공하는 옵션들이 있습니다. 여러 스레드에서 파싱하려면 multithreading 기능이 필요하며, 이는 기본적으로 활성화되어 있습니다.

API 레퍼런스는 docs.rs에서 확인할 수 있습니다.

성능

도구 다운로드

인기

모두 보기 →

커뮤니티에서 가장 많이 사용되는 도구를 찾아보세요.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 궁극의 OSINT 툴킷: 조사 그래프, 신뢰도 점수 산정, 별칭 패밀리, 지도, 타임라인 및 보고서. 49개 모듈, 400개 이상 사이트, API 키 불필요.

    930
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    # GhostLock 원탭 실행 앱 (CVE-2026-43499)

    554
  • 3

    redforge

    cybersecurity91/redforge

    브라우저 측 레드 팀 툴킷으로, 정찰, 페이로드 생성, 자격 증명 공격, 암호화, 인코딩 및 참여 보고를 위한 102개의 오프라인 도구를 제공합니다.

    354
  • 4

    ARTEX

    baarai/artex

    LLM 멀티 에이전트 자율 침투 테스트 플랫폼으로, 플래너/워커 에이전트, 자산 및 탐색 그래프, MITM 트래픽 기록, 취약점 재테스트 기능을 제공합니다.

    349
  • 5

    looking-glass

    anonghosty/looking-glass

    Shadowserver 보고서를 MongoDB로 수집하고 이를 대화형 지도, 분석, 발견 사항, 권고 및 경영진 대시보드로 재생하는 CSIRT 플랫폼입니다.

    326
  • 6

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    AI 네이티브 사이버보안을 위한 행동 체계—의도가 통제된 실행이 되고, 증거가 운영 메모리가 되며, 모든 운영이 다음 운영을 개선하는 곳.

    289

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →