Commit Graph
100 Commits
Author SHA1 Message Date
NK f3b4c2269a Fix Python availability claim: included in ESXi 6.x+, not all versions 2026-03-25 00:54:33 +01:00
NK 3ed50ef292 Move loader to tools/, bundle in ESXi release archive
- vmkatz_loader.py moved to tools/vmkatz_loader.py
- Release workflow includes the loader in the esxi-x86_64 tar.gz
- Updated README and docs/esxi.md paths
2026-03-25 00:52:57 +01:00
NK f8c72d0ef8 Fix vmkatz_loader.py header: document Python 2.7+ compatibility 2026-03-25 00:50:40 +01:00
NK 1410fa7c3f Reorganize README: move detailed docs to docs/
README trimmed from 524 to 175 lines. Moved to docs/:
- docs/esxi.md — ESXi deployment, VIB bypass, VMFS raw access
- docs/examples.md — Example output (LSASS, hashcat, NTDS, pagefile)
- docs/architecture.md — Module layout and how it works
- docs/tested-targets.md — Test matrix and known limitations

README now focuses on: intro, what it extracts, supported inputs,
quick start, output formats, ESXi basics, build features, and links.
2026-03-25 00:47:30 +01:00
NK f60065a93f Document Python loader for ESXi VIB bypass, add VIB field to bug template
- README: new section explaining vmkatz_loader.py usage when
  execInstalledOnly is enabled, with command to check VIB status
- Bug template: add ESXi VIB protection field asking for
  execInstalledOnly value and ESXi version
2026-03-25 00:40:09 +01:00
NK 21c39c4451 Merge branch 'mmap-fallback' into dev 2026-03-25 00:31:10 +01:00
NK c22350df31 Add Python in-memory ELF loader for ESXi VIB bypass
Loads vmkatz into anonymous mmap pages with PROT_EXEC, bypassing
execInstalledOnly on ESXi. VMkernel blocks execve on unsigned binaries
but allows PROT_EXEC on anonymous mappings. Python is VIB-signed.

The loader parses ELF64 headers, maps PT_LOAD segments, applies
R_X86_64_RELATIVE relocations for PIE, builds a proper initial
stack with argc/argv/envp/auxv (AT_PHDR, AT_PHNUM, AT_PAGESZ,
AT_RANDOM for musl TLS init), and jumps to _start via trampoline.

Usage: python3 vmkatz_loader.py /tmp/vmkatz [args...]
2026-03-25 00:27:30 +01:00
NK 4b9a84a56b Add volatility-kerberos acknowledgement for ticket carving inspiration 2026-03-22 00:14:25 +01:00
NK 1652c36982 Add Kerberos ticket carving from LSASS memory
Scans LSASS virtual memory for orphaned _KERB_TICKET_INFO structures
that are no longer in the AVL session tree (freed sessions, logged-out
users with memory still resident). Recovers tickets missed by the
normal AVL tree walk.

Approach: scan for valid etype values at ticket_enc_type offsets, then
validate surrounding structure (kvno, ticket_length, flags, service
name pointer) before calling extract_single_ticket for full parsing.
Tries all known TicketOffsets variants (Win7/8/10/11). Deduplicates
against tickets already found by the structured extraction.

Runs automatically after the normal Kerberos provider extraction.
2026-03-21 23:14:53 +01:00
NK d9b35a1eab Add transparent BitLocker disk decryption using FVEK from memory
When BitLocker FVEK keys are extracted from a VM memory snapshot,
vmkatz can now use them to decrypt the corresponding encrypted disk
for SAM/NTDS extraction in the same run.

New modules:
- sam/aes_xts.rs: AES-XTS-128/256 sector-level decryption
- sam/bitlocker_decrypt.rs: transparent Read+Seek wrapper that
  decrypts sectors on-the-fly, validates FVEK by checking for
  NTFS signature in decrypted sector 0

Flow: snapshot → extract FVEK → open disk → detect BitLocker →
try each FVEK candidate → decrypt partition → extract credentials.
Works in directory mode (auto-discovers snapshot + disk) and with
explicit --disk flag.
2026-03-21 15:58:32 +01:00
NK e6d6ef36df Add BitLocker FVEK extraction from VM memory snapshots
Scans physical memory for Windows pool tags to extract Full Volume
Encryption Keys, enabling offline decryption of BitLocker volumes:
- FVEc pool tag (Win7): AES-128/256-CBC, Elephant Diffuser modes
- Cngb pool tag (Win8+): AES-128/256-XTS modes
- Dual-copy validation for Cngb, entropy checks for both
- Tries both x64 and x86 structure offsets automatically

Output: hex FVEK in text/csv/hashcat formats, dislocker-compatible
.fvek files via --bitlocker-fvek <dir>. Works in both normal and
--carve modes (physical scan, no LSASS context needed).
2026-03-21 13:03:52 +01:00
NK b0e6894509 Include file path in mmap fallback warning message 2026-03-21 12:03:40 +01:00
NK 3e811eaf88 Add pread fallback when mmap fails (e.g. ESXi 6.5 VMkernel)
MappedFile now has a Pread variant that uses read_exact_at() instead
of memory mapping. When mmap returns EINVAL (unsupported by kernel),
vmkatz falls back to file I/O with a clear warning message.

Layers updated to use read_at() for PhysicalMemory::read_phys:
- VMware: pread for runtime reads, header parsed from first 8MB buffer
- Hyper-V: pread for all reads
- QEMU ELF: pread for runtime reads, ELF header parsed from 1MB buffer
- QEMU savevm: requires mmap (stream parsing needs full slice access)

Zero host RAM impact — pread reads directly from disk to caller buffer.
2026-03-21 11:51:26 +01:00
NK 95162782e5 Bump version to 1.3.0 2026-03-21 03:22:51 +01:00
NK 1bd901baf2 Fix potential panics: bounds-check QEMU reads, guard VHDX division by zero
- qemu/savevm.rs: read_be_u32/read_be_u64 now use .get() instead of
  direct indexing — returns 0 instead of panicking on truncated input
- disk/vhdx.rs: guard against chunk_ratio=0 which would cause division
  by zero on crafted VHDX files with oversized block_size
- main.rs: suppress dead_code warning for QemuSavevm variant in
  non-qemu single-feature builds
2026-03-21 03:13:20 +01:00
NK 33a357875f Sort orphan VMDK extents in discovery to pick lowest-numbered first
When no text descriptor exists and only -sNNN extent files are present,
the discovery code now sorts extents before picking the first one.
Previously it used filesystem iteration order which was non-deterministic.
2026-03-21 03:03:35 +01:00
NK 044f3b28da Improve mmap failure error message with file size context 2026-03-21 02:39:33 +01:00
NK e4c943ea4f Remove read_to_end fallback from VMware layer
The Vec<u8> fallback was added for ESXi kernels where mmap failed on
VMFS-5 files. Now that mmap_file() handles block devices and edge cases,
the fallback is unnecessary and dangerous — it would silently try to
allocate hundreds of GB for large VMEM files if mmap ever failed.
2026-03-21 02:35:36 +01:00
NK 99abb25518 Centralize mmap and file_size helpers for block device compatibility
Mmap::map() uses fstat which returns 0 for block devices (LVM volumes).
Added utils::mmap_file() that uses seek to get real size and passes it
explicitly to MmapOptions. Replaced all Mmap::map() calls across:
- qemu/savevm.rs (was already fixed inline, now uses shared helper)
- qemu/layer.rs (ELF core dumps)
- hyperv/layer.rs (.bin/.raw dumps)
- vmware/layer.rs (fallback path also used metadata().len())
- hyperv/vmrs.rs (used metadata().len() for size)
- vbox/layer.rs (used metadata().len() for size)

Also added utils::file_size() for non-mmap size queries.
2026-03-21 02:29:53 +01:00
NK e2936dc9d3 Add VMFS-5 support to raw VMFS parser
The parser previously rejected VMFS-5 (majorVersion < 24). Now handles
both VMFS-5 and VMFS-6 with version-dependent branching for:
- File descriptor size (2048 vs 2*mdAlignment) and layout
- Block pointers (32-bit vs 64-bit)
- Address encoding (FB vs SFB/LFB, different bit layouts)
- Directory format (flat 140-byte entries vs block-based 288-byte)
- Pointer blocks (4KB/1024 ptrs vs 64KB/8192 ptrs)
- Resource metadata (no rfmd signature in VMFS-5)
- SFD bootstrap offset formula
- TBZ bits (VMFS-6 only, not in 32-bit addresses)

Verified on both VMFS-5 and VMFS-6 datastores.
2026-03-21 02:22:53 +01:00
NK ade266a88a Fix QEMU savevm detection and mmap on block devices (LVM volumes)
Block devices (e.g. /dev/pve/vm-*-state-*) were incorrectly routed
to SAM disk extraction instead of QEMU savevm parsing. Two fixes:

- Check QEVM magic on block devices before assuming SAM mode
- Use read_exact instead of mmap for is_qemu_savevm() detection
- Use explicit size via seek(End) for mmap in QemuSavevmLayer::open(),
  since fstat returns 0 for block devices
2026-03-21 01:53:24 +01:00
NK 1a7276b870 Update README: mark VHDX as tested (Win2003R2, Win2012R2) 2026-03-21 00:57:42 +01:00
NK 8bc31a4a36 Update README: document SAM account status and DPAPI dedup 2026-03-21 00:53:34 +01:00
NK 56632a865c Improve DPAPI and SAM display: account status, key dedup, NTFS 8.3 fix
- Show account status in SAM text output: (DISABLED), (NO PASSWORD),
  (BLANK PASSWORD) from per-user ACB flags in registry F value
- Add modification date to DPAPI master key text output from NTFS mtime
- Deduplicate DPAPI keys: show only most recent per user (--all for all)
- Filter NTFS DOS 8.3 short names in list_directory() — fixes S-1-5-~1
  SID leak from short name aliases
- Add cargo test step to CI workflow
2026-03-21 00:52:56 +01:00
NK 131a3693b2 Demote empty LSA secret warning to debug level 2026-03-21 00:10:32 +01:00
NK c336acb133 Fix DPAPI hashcat mode: distinguish local (15300/15900) from domain (15310/15910)
The hashcat mode depends on context (local vs domain user), not just the
crypto version. Domain users use NTLM pre-key derivation (modes 15310/15910)
while local users use SHA1 pre-key (modes 15300/15900). The context is
determined by whether a domain key section exists in the master key file.

Previously all hashes were reported as 15300 or 15900 regardless of context.
2026-03-21 00:06:07 +01:00
NK 52692984e6 Log warnings on I/O errors in file discovery instead of silently skipping
Previously, permission errors, mount failures, or I/O issues during VM
file discovery were silently swallowed with if-let-Ok patterns. On a NAS
with partial mounts or restricted permissions, this caused VMs to be
silently missed with no indication of the problem.

Now all I/O errors in discover.rs produce log::warn! messages:
- read_dir failures on scan directories
- metadata/stat failures on individual files
- file open failures in magic-byte checks (ELF, VMDK descriptor)

Added file_size() helper to centralize metadata reads with warnings.
2026-03-20 23:55:28 +01:00
NK 75f495134f Clean up magic numbers and improve readability
- savevm.rs: extract RAM_FLAG_MASK constant, remove unused _block_gpa_bases param
- lsa.rs: extract DES_KEY_SEGMENT constant, add [MS-LSAD] spec references,
  document key rotation algorithm with example
- cloudap.rs: extract MAX_PRT_SIZE constant, remove extra blank line
2026-03-20 23:31:34 +01:00
NK 58cc80abaf Add changelog generation to release workflow 2026-03-20 22:53:10 +01:00
NK 6f0bd040b3 Bump version to 1.3.0-beta.1 and support pre-release tags in CI
Release workflow now marks tags containing -beta, -alpha, or -rc as
GitHub pre-releases.
2026-03-20 22:41:59 +01:00
NK 7ec43a1f59 Merge branch 'main' into dev
# Conflicts:
#	src/lsass/kerberos.rs
#	src/lsass/msv.rs
2026-03-20 22:38:15 +01:00
NK 9506c50bda Update README for QEMU savevm, embedded .vmsn, BitLocker, and legacy LSA support
- Add QEMU/Proxmox savevm and VMware embedded .vmsn to supported inputs
- Add ESXi 6.7 and Proxmox savevm test results to tested targets table
- Document BitLocker detection and QEMU savevm limitations
- Update target OS range to include Windows Server 2003
- Add Proxmox example to quick start
- Update module architecture and feature descriptions
2026-03-20 22:33:37 +01:00
NK 84ec71d5b9 Fix legacy LSA secret decryption (pre-Vista / Windows 2003)
Two bugs fixed:
1. LSA key derivation: MD5 input was salt+bootkey×1000 instead of
   bootkey+salt×1000 (wrong order per impacket/MS-LSAD spec)
2. Secret decryption: used RC4 instead of DES-ECB with rotating
   7-byte key segments (SystemFunction005 / [MS-LSAD] Section 5.1.2)

Implemented:
- DES-ECB decrypt with rotating key (des_ecb_decrypt_rotating)
- transformKey: 7-byte to 8-byte DES key expansion ([MS-LSAD] 5.1.3)
- LSA_SECRET_XP parsing: Length(4) + Version(4) + Secret(Length)

Tested on Windows Server 2003 R2 SP2 VHDX: DPAPI_SYSTEM keys and all
LSA secrets now decrypt correctly.
2026-03-20 22:27:59 +01:00
NK 313b0df30a Fall back to legacy LSA key when PolEKList is missing despite modern revision
Windows Server 2003 R2 SP2 reports PolRevision 0x10007 (modern) but uses
the legacy PolSecretEncryptionKey scheme. Try PolEKList first; if not found,
fall back to PolSecretEncryptionKey instead of failing.
2026-03-20 21:40:11 +01:00
NK 49a3991faa Detect BitLocker-encrypted partitions and warn the user
Check for the -FVE-FS- OEM ID in partition boot records before
attempting NTFS parsing. When BitLocker is detected, skip the
partition and display a clear error message instead of failing
silently with "No registry hives found".

Applied to SAM extraction, LSA secrets, and NTDS.dit extraction paths.
2026-03-20 21:33:51 +01:00
NK febbb0e4d9 Fix embedded .vmsn memory and hide machine account passwords
VMware layer:
- Fix base_offset not set when .vmsn has region tags but no separate
  .vmem file (embedded memory). Reads were at wrong file offset.
- Tested on ESXi 6.7 with Win Server 2016 embedded .vmsn snapshot.

Display:
- Don't display Kerberos/WDigest passwords for machine accounts (username
  ending with $) — they are binary blobs, not useful plaintext. The
  Kerberos keys (AES256, RC4=NT hash) are the exploitable forms.
- Don't count machine passwords in the summary line.
- Truncate long hex passwords to "(hex, N bytes) first32bytes..." when
  displayed for other non-printable passwords.
2026-03-20 21:27:51 +01:00
NK abb72761ab Add QEMU/KVM/Proxmox savevm state parser and improve System process discovery
New parser (src/qemu/savevm.rs):
- Parse QEVM magic, RAM block list, and page entries (PAGE/ZERO)
- MMIO gap remapping for q35+UEFI (below_4g=0x80000000)
- Skip non-RAM device sections (dirty-bitmap, etc.) via forward scanning
- HashMap-based deduplication for dirty page iterations (last-write-wins)
- Auto-detection via QEVM magic in format dispatcher

System process discovery improvements:
- Validate candidates by translating Flink VA to physical and checking the
  linked EPROCESS has a printable ImageFileName and valid kernel-mode Flink
- Rejects stale EPROCESS remnants with corrupted page tables

Tested on Proxmox VMs: DC25 (Win Server 2025, 4GB) and WKS11 (Win11, 8GB)
2026-03-20 19:28:54 +01:00
NK 552d444cfe Unify Kerberos credential extraction for x64/x86
- Merge 8 duplicated _x86 functions into single arch-aware implementations:
  walk_avl_tree, read_kerb_external_name, extract_kerb_password,
  extract_tickets_from_list, extract_single_ticket, detect_kerb_offsets,
  extract_kerb_keys, extract_kerberos_credentials
- All structure offsets computed from arch.ptr_size() and arch.ustr_size()
- Delete extract_kerberos_credentials_arch wrapper and all _x86 variants
- Net reduction: -580 lines
2026-03-20 19:27:19 +01:00
NK 649976e96a Unify MSV session and credential extraction for x64/x86
- Merge extract_msv_sessions_arch and extract_msv_credentials_arch into the
  main functions, selecting offset variants by arch at runtime
- Make all walkers arch-aware: walk_session_buckets, walk_session_list,
  walk_msv_list, walk_hash_table, find_inline_hash_table,
  find_credentials_ptr_in_entry
- Delete 258 lines of duplicated x86 code (extract_msv_sessions_arch,
  extract_msv_credentials_arch, try_extract_primary_cred_x86)
- x86 now gets scoring, enrichment, multi-pass credential scanning, and
  SHA1 validation — previously x64-only features
- Add variant_order_for_build_arch for x86 build-aware variant ordering
2026-03-20 19:26:55 +01:00
NK b0c8bcae49 Refactor LSASS providers: extract shared helpers and unify x64/x86 code paths
- Add read_ptr_from_buf, walk_list, read_data_section, scan_data_for_list_head
  to types.rs, eliminating ~200 lines of duplicated boilerplate across providers
- Unify kerberos.rs: merge 8 duplicated _x86 functions into arch-aware versions
  (walk_avl_tree, extract_single_ticket, read_kerb_external_name, etc.), -440 lines
- Fix CloudAP: read account name from toName_ptr (+0x58) instead of hashName (+0x68)
  which is a SHA hash, not the readable UPN. Add 3 offset variants (1507-1607,
  1703-1709, 1803+) with auto-detection. Remove useless hashName fallback.
- Fix walk_session_buckets using x64-only read_win_unicode_string and read_virt_u64
  for pointers — now uses arch-aware read_ustring and read_ptr
2026-03-20 19:26:30 +01:00
NK 35fc30e0a3 Add GitHub issue templates for bug reports and feature requests
Bug template requires: vmkatz version, input format, guest OS/arch,
host platform, filesystem, full command output, and file details.
Blank issues disabled to enforce structured reports.
2026-03-18 23:26:06 +01:00
NK d3ab21d11b Handle Kerberos ISO passwords, SmartCard PINs, and MSV CredentialKeys
Kerberos:
- Detect Credential Guard ISO-encrypted passwords (type==1 at cred+0x28)
  on Win10 1607+. Report as "(Credential Guard ISO)" instead of silently
  failing to decrypt.
- Extract SmartCard PINs from SmartcardInfos pointer (CSP_INFOS.PinCode)
  when regular password is empty. Stored as "[PIN] <pin>".
- Add smartcard_infos offset to KerbOffsets for Win10 1607+ variants.

MSV:
- Walk the KIWI_MSV1_0_PRIMARY_CREDENTIALS linked list via next pointer
  to find the "Primary" entry, instead of assuming the first entry is it.
- Recognize "CredentialKeys" (ANSI_STRING len=14) entries alongside
  "Primary" (len=7) during structure scanning and inline byte matching.
- Skip CredentialKeys entries (DPAPI key material already extracted by
  DPAPI provider) with a log message.
2026-03-18 00:17:04 +01:00
NK 3706710552 Add x86 EPROCESS offsets for Vista/Win7/Win8/8.1 and fix Vista x86 classification
- Add EPROCESS offset tables for Vista SP2 x86, Win7 SP1 x86, Win8/8.1 x86
- Fix is_prevista_x86 threshold: Vista x86 (PID=0x9C) uses AES/3DES like
  Win7+, not DES-X/RC4. Tighten cutoff from 0xA0 to 0x98.
- Update README: 18 offset tables, correct x86 support status
2026-03-18 00:03:20 +01:00
NK e2c078d4f7 Bump version to 1.2.2 2026-03-17 23:27:00 +01:00
NK 06397923d2 Flip EPT scanning to opt-in and remove dev examples from repo
EPT scanning (for VBS/Credential Guard VMs) is now disabled by default
and enabled with --ept, since the vast majority of VMs don't use VBS.
Previously it was enabled by default and disabled with --no-ept.

Also remove examples/ (dev-only test utilities) from tracking.
2026-03-17 23:24:03 +01:00
NK 97d1d18c6f Support VBox 5.x-7.x PGM saved state versions in .sav parser
The PGM struct fields size varies by VirtualBox version:
- v14 (VBox 7.x): 78 bytes — existing behavior
- v12-13 (VBox 5.x-6.x): 74 bytes — no cBalloonedPages field
- v11 (VBox 4.1+): 70 bytes — pre-balloon support

Previously hardcoded to skip(78), which corrupted RAM extraction
for any .sav file not from VBox 7.x. Now reads the PGM unit
version from the unit header and adapts accordingly.
2026-03-17 23:16:40 +01:00
NK 6a52381e46 Update README.md
- Split Quick Start into basic and advanced sections
- Fix binary size: ~5 MB → ~3 MB in ESXi deploy section
- Update module architecture tree with all source files:
  disk/ (vmdk, vdi, qcow2, vhd, vhdx, raw), sam/ (hive, bootkey,
  hashes, lsa, cache, dpapi_masterkey, ntfs_fallback), paging/
  (translate, entry, filebacked), pe/, utils
2026-03-17 14:42:46 +01:00
NK 4afa6eec69 Update README.md
- Add DPAPI master key hashes (hashcat 15300/15900) to disk extraction list
- Document missing CLI options: -r/--recurse, --scan, --provider, --no-ept,
  -v/--verbose, --build, --format brief
- Add brief format to output formats table
- Add dissect.vmfs (Fox-IT) and vmfs-tools to acknowledgements
2026-03-17 14:18:13 +01:00
NK 90074c601a Update README.md 2026-03-17 12:23:09 +01:00
NK 2f01b48258 Validate GPT entry size before allocation and slice access
Reject entry_size outside 128-4096 range to prevent:
- panic on slice &entry[0..16] when entry_size < 16
- OOM allocation from forged u32 entry_size
GPT spec mandates minimum 128 bytes per partition entry.
2026-03-17 02:16:51 +01:00
NK a1e0a65e7f Fix VDI parent resolution and coalesce_pages overflow
- VDI: search for location= attribute AFTER the UUID match, not in a
  window that extends 200 bytes before it. Prevents picking a location
  from a different HardDisk entry in multi-disk .vbox files.
- dump: use saturating_add/sub in coalesce_pages to prevent u64
  overflow on kernel addresses near 0xFFFFFFFFFFFFF000.
2026-03-17 01:52:05 +01:00
NK 75b2351363 Fix cfg gate on fmt_lm_pwdump: sam feature, not ntds.dit
The function is used by both SAM and NTDS output paths. Gating it on
ntds.dit broke compilation when sam was enabled without ntds.dit
(e.g. --features sam or --features vmfs).
2026-03-17 01:48:26 +01:00
NK 09dae5b16c Cap QCOW2 L1 table allocation and fix VMware tag parsing
- QCOW2: cap l1_table pre-allocation to 1M entries to prevent OOM
  from forged l1_size in header (actual entries read from file)
- VMware tags: validate all index bytes are available before parsing,
  break out of tag loop instead of producing truncated indices
2026-03-17 01:41:56 +01:00
NK 873c93357d Validate NTFS boot sector cluster_size and record_size
Reject zero values parsed from untrusted NTFS metadata to prevent
division-by-zero panics in cluster offset and MFT record calculations.
2026-03-17 01:40:05 +01:00
NK f99b1a4c74 Guard VMware parser against malformed .vmsn files
- Bounds-check tag_start before slicing vmsn_data (prevents panic on
  forged memory_group.offset beyond file size)
- Cap Vec::with_capacity for group_count based on actual data size
  (prevents OOM from forged u32 in header)
- Cap regions Vec::with_capacity to 4096 (prevents OOM from forged
  regionsCount tag value)
2026-03-17 01:33:35 +01:00
NK e538e27209 Harden SAM/ESE/VMFS parsers against malformed inputs
- SAM hashes: use saturating_add + checked_add for V-value offset
  calculations to prevent overflow on crafted hive data
- ESE: check tag_idx overflow in read_tag before subtraction from
  page_size (prevents wrap-around on large tag indices)
- ESE: explicit guard last_var_id < 128 in variable column parsing
  to prevent underflow in offset table size calculation
- VMFS flat VMDK: guard block_size == 0 in resolve_position and Read
  impl to prevent division by zero on corrupt superblock
2026-03-17 01:29:33 +01:00
NK f798f59224 Harden parsers against malformed inputs
- MSV: propagate arch parameter instead of hardcoding Arch::X64,
  fixes credential extraction on x86/WoW64 processes
- VMDK: validate grain_size != 0 and numGTEsPerGT != 0 (div-by-zero)
- VMDK: reject extent number 0 in parse_extent_number (underflow)
- VHDX: validate block_size and logical_sector_size != 0
- VHD: validate block_size != 0 in dynamic header
- VMFS: guard file_block_size, clusters_per_group, and
  parent_resources_per_group against zero (div-by-zero)
- QEMU ELF: use checked arithmetic for program header offsets
- VMware tags: bounds-check data_size before advancing parse position
- Process walk: guard flink_phys underflow in enumerate_processes
2026-03-17 01:22:11 +01:00
NK 1658606d1a Bump version to v1.2.1
- Fix SSP decryption: use AES-CFB-8 instead of CFB-128 (matches mimikatz)
- Fix machine account password display: raw hex instead of lossy UTF-16
- Truncate decrypted passwords to UNICODE_STRING.Length (drop padding)
2026-03-16 23:34:33 +01:00
NK 5115e632ef Fix lossy password decoding for machine accounts
- Truncate decrypted password to UNICODE_STRING.Length bytes (was using
  MaximumLength, including garbage padding after the actual data)
- Add decode_password_bytes: hex-encode raw bytes directly for binary
  passwords instead of round-tripping through lossy UTF-16LE decode
  (char::REPLACEMENT_CHARACTER destroyed original bytes)
- Apply to all providers via decrypt_unicode_string_password_arch and
  the SSP-specific CFB-8 variant
- Update CSV/text output to use raw hex for binary passwords
2026-03-16 23:28:18 +01:00
NK 5f24e8f528 Add missing vmrs.rs module 2026-03-16 23:02:10 +01:00
NK dab403c139 Bump version to v1.2.0
- Fix SSP decryption: use AES-CFB-8 (8-bit segments) instead of CFB-128.
  SSP is the only LSASS provider using CFB-8 (mimikatz: KP_MODE_BITS=8).
  Previously produced garbage output for SSP passwords.
- Fix .vmsn hang: mmap metadata instead of loading entire multi-GB file
- Reduce EPT scan budget (4GB cap, 1GB gap) for faster non-VBS bail-out
- Fix crash on ESXi: spawn 8MB stack thread (ESXi default is 512KB)
- Add credential deduplication: merge duplicate sessions by default (-a for all)
- Add version banner at startup
- Fix snapshot labels: recognize .vmss and .vmrs extensions
- Add Hyper-V VMRS saved state support
- Add Clone derives on credential types
2026-03-16 22:57:08 +01:00
NK 55aa12199c Update README.md 2026-03-16 18:08:30 +01:00
NK 9014a3f2ef Bump version to v1.1.1
- Fix .vmsn hang: use mmap instead of fs::read for metadata parsing,
  avoiding multi-GB allocation on embedded memory snapshots
- Reduce EPT scan budget (4GB cap, 1GB gap limit) for faster bail-out
  on non-VBS VMs (70s → 10s on 16GB snapshot)
2026-03-16 18:05:57 +01:00
NK f6001f8a0b Bump version to v1.1.0
New features: VMFS-6 raw SCSI parser, native Hyper-V VMRS parser.
2026-03-10 11:01:47 +01:00
NK 9c74207520 Expand VMFS-6 section with discovery, auto-scan, and internals
Detail the --vmfs-list device discovery with example output, single-VM
vs auto-scan extraction modes, NTFS partition filtering for batch mode,
and the on-disk resolution chain diagram.
2026-03-10 10:55:32 +01:00
NK 8ddbcd28c4 Update README with VMFS-6 raw parser and Hyper-V VMRS support
Add documentation for two major new features:
- VMFS-6 raw SCSI device parser that bypasses ESXi file locks on running VMs
- Native Hyper-V .vmrs saved state parser (reverse-engineered, no Microsoft DLL)
2026-03-10 10:53:45 +01:00
NK 6c35d9f242 Add VMFS feature flag, device enumeration, and fix all clippy warnings
VMFS module:
- Gate behind `vmfs` Cargo feature (included in defaults, depends on sam)
- Add --vmfs-list to discover VMFS-6 devices and flat VMDKs on ESXi
- Add --vmfs-device/--vmdk auto-scan with NTFS partition pre-check
- Fix label reading: use data_offset at LVM header 0x7A (not 0xC8)
- Filter out duplicate vml. symlink devices

Clippy fixes across all feature combinations:
- Remove unused fields, methods, constants in vmfs.rs
- Remove redundant `as u64` casts, use div_ceil()
- Gate MSSK_TAG and fmt_lm_pwdump behind their feature flags
- Simplify boolean expressions in ntfs_fallback.rs
- Suppress unit-type warnings for PagefileRef/DiskPathRef cfg stubs

Zero warnings on: --features vmware, all-except-vmfs, --all-features.
2026-03-10 03:01:13 +01:00
NK 2beb89a745 Add resilient I/O for reading live/in-use block devices
On Proxmox (and ESXi with VMFS), reading disk images of running VMs
can hit transient I/O errors on individual sectors/clusters that are
temporarily locked by the hypervisor.

Instead of aborting on the first read error, all NTFS and registry
hive reading paths now use block-level resilient I/O:
- read_from_data_runs: reads 4KB blocks individually, zero-fills
  blocks that fail, and continues to the next block
- resilient_read_blocks: MFT batch reads zero-fill failing records
  instead of skipping entire batches
- read_file_data (ntfs_reader): falls back to chunked 4KB reads
  when exact read fails
- Partition table parsing: skips unreadable GPT entries gracefully
- Hive scanning: skips unreadable chunks instead of aborting scan
- MFTMirr: accepts records without FILE signature check on first
  extent (live VMs may have transient I/O on header sectors)
- $ATTRIBUTE_LIST parsing for extension MFT records (large hives)

Tested on Proxmox with running Win11 and DC VMs — extracts SAM/SYSTEM
hives and NTDS.dit successfully despite scattered I/O errors.
2026-03-10 03:00:59 +01:00
NK 0a1febd8f0 Add VMFS-6 raw parser for direct ESXi SCSI device access
Self-contained VMFS-6 parser that reads flat VMDKs directly from raw
SCSI partition devices, bypassing VMFS file locks on running VMs.

Key features:
- Full VMFS-6 on-disk format parsing: LVM, superblock, FDC, SBC, PB/PB2
- Directory traversal with allocation map and entry bitmap support
- Block map building with batched PB reads (320 reads vs 262K individual)
- Sub-block resolution for small files via SBC resource metadata
- Auto-scan mode: enumerates all VMs, skips non-Windows VMDKs
- NTFS-only extraction for fast batch scanning

Verified on ESXi 8.0 datastore: 73 VMDKs scanned in <2min, 4 Windows
VMs with SAM hashes + LSA secrets + DCC2 cached credentials extracted.
2026-03-10 02:31:40 +01:00
NK a386bc19d5 build: replace env_logger with inline logger (3.0M → 2.3M)
env_logger pulled in regex + jiff (~700KB). Replace with a 10-line
SimpleLogger that writes to stderr. Same behavior, zero dependencies.
2026-03-09 16:53:27 +01:00
NK 85348ed84f build: optimize binary size (4.0M → 3.0M)
- Add opt-level = "z" to release profile (size-optimized codegen)
- Remove redundant strip/editbin steps from CI (strip = true in Cargo.toml
  already handles all targets)
- Remove redundant --features "ntds.dit" (already in default features)
2026-03-09 16:39:30 +01:00
NK d616a62775 v1.0.0: major rewrite — minidump support, pre-Vista, verified offsets, carve mode
LSASS credential extraction:
- Minidump (.dmp) support: full MSV/Kerberos/DPAPI/WDigest/TsPkg/SSP/
  LiveSSP/CredMan/CloudAP extraction from LSASS minidumps
- Pre-Vista (WinXP/Win2003): 32-bit EPROCESS, PAE paging, DES-X-CBC/RC4
- Win11 24H2 (26100+): correct EPROCESS offsets, MSV LIST_64/LIST_65,
  Kerberos variant with shifted offsets
- All MSV/SSP/LiveSSP/CloudAP/CredMan/WDigest offsets verified against
  mimikatz C structs and pypykatz templates
- EPROCESS offsets verified against Vergilius Project (13 variants)
- AES-CFB-128 cipher for non-8-aligned LSASS blobs
- DPAPI extraction from dpapisrv.dll (Win10 19041+ moved g_MasterKeyCacheList)
- Adaptive MSV offset discovery with build-number-aware variant ordering
- MSV NT hash fix: validated variant tracking + DPAPI cross-check for
  human accounts (SHA1 validation only works for machine accounts)
- Kerberos: AES/DES/RC4 key extraction, kirbi/ccache export, ticket
  quality validation, false positive filtering
- CloudAP: PRT blob extraction, 7 patterns covering Win10 1507–Win11 24H2
- CredMan: correct 2-level navigation (SET_LIST→STARTER→entry)
- Garbage filtering: repeating pattern detection, structural score
  validation, unknown etype rejection

Architecture:
- Carve mode: two-level degraded extraction for truncated memory files
- sam/mod.rs split into 4 submodules (partition, ntfs_reader,
  disk_fallbacks, vmdk_scan)
- ProviderStatus enum replacing string-based status tracking
- Safe read helpers (utils.rs) replacing 86 try_into().unwrap() calls
- GovmemError renamed to VmkatzError across all 35 source files
- Named paging constants (PAGE_PHYS_MASK, LARGE_*_MASK)

Performance:
- TLB cache for page table translation (256-entry direct-mapped)
- QCOW2 L2 table caching (64 tables, amortized I/O)
- VMware region binary search (partition_point)
- Stack-allocated ASN.1 length encoding, IV entropy histogram
- Single-pass System process + EPT scanning
- memchr::memmem for pattern matching

Robustness:
- Minidump parser hardening (bounds checks, overflow protection)
- PE32 validation (machine type, section count, optional header size)
- Multiple pagefile support (PTE pagefile_number routing)
- VMware embedded memory support (.vmss/.vmsn without .vmem)
- EPT false positive prevention (reserved bits, PDPT validation)
- VMEM truncation detection with user warning

Testing:
- 8 automated tests (4 unit + 4 integration)
- Non-regression framework: compare.py + esxi_test.sh
- All credentials verified against pypykatz on 10+ minidumps

CLI:
- --all/-a: show empty sessions (hidden by default)
- --no-ept: skip EPT scanning
- --kirbi/--ccache: Kerberos ticket export
- Silent output modes: ntlm, hashcat, text summary
- Hex display for non-printable machine account passwords
2026-03-09 16:21:24 +01:00
NK ac15c32d37 Fix MSV NT hash variant selection for human accounts
SHA1 cross-validation only works for machine accounts (where
ShaOwPassword = SHA1(NTHash)). For human accounts, ShaOwPassword =
SHA1(UTF16LE(password)), so the entropy fallback could pick the wrong
offset variant (reading DPAPI Protected field as NT hash).

Two fixes:
- Track SHA1-validated variant across credentials in same LSASS process
  (same Windows build → same offsets). Reuse for subsequent credentials.
- DPAPI cross-check: when isDPAPIProtected=1, reject entropy candidates
  whose NT hash matches the DPAPIProtected field at offset 0x6A.

Verified: Administrator NT hash now correct (09f6ff15...) on both
Citrix DC snapshots, matching pypykatz ground truth.
2026-02-26 12:18:37 +01:00
NK 0dd011dd49 Fix false positive tickets and improve MSV credential matching
- Validate Kerberos tickets: reject paged-out blobs (>75% zeros),
  garbage key_types (>0xFF), and all-zero timestamps
- Improve MSV physical scan LUID matching: match by username only
  when domain is empty or "." (local machine shorthand)
- Eliminates synthetic LUIDs and garbage ticket output
2026-02-26 04:24:55 +01:00
NK f2bd87d305 Add physical scan for Kerberos keys and fix credential matching
- Extract pKeyList keys even when credential substructure is paged out
- Physical scan for KIWI_KERBEROS_KEYS_LIST_6 structures in LSASS pages
- Match key groups to credentials via RC4 key = NT hash correlation
- Merge Kerberos credentials by username/domain when LUID is unknown
- Remove duplicate DPAPI line (was always same as SHA1)
- Hide all-zero LM hashes in output
2026-02-26 03:21:33 +01:00
NK 2700102ae9 Add --kirbi and --ccache flags for Kerberos ticket export
- --kirbi <DIR>: export individual .kirbi files per ticket
- --ccache <FILE>: export all tickets as MIT Kerberos ccache v4 format
- Uses actual Kerberos name types from ticket data for ccache principals
- Sanitizes filenames for cross-platform compatibility
2026-02-25 23:38:02 +01:00
NK 1dcda44efe Add Kerberos AES/DES/RC4 key extraction from pKeyList
Read KIWI_KERBEROS_KEYS_LIST_6 from the session entry's pKeyList
pointer, parse KERB_HASHPASSWORD_6[_1607] entries, decrypt and
extract AES128, AES256, RC4 (NTLM), and DES key material.

Offsets for Win10 1607+, Win10 1507, Win8, and Win7 variants.
Keys are displayed in both text and Display formats.

This closes the gap vs pypykatz which extracts these keys from
minidumps. VMkatz now extracts passwords, keys, and tickets.
2026-02-25 23:28:35 +01:00
NK 28afe24f98 Filter false positive LSASS sessions from garbage memory
Add LUID and username validation to reject phantom sessions caused by
wrong MSV struct offsets being applied to valid memory. Filters:
- LUID must have high 32 bits zero (real Windows LUIDs are 32-bit)
- Username must contain at least one alphanumeric char, no file paths
  or control characters

Tested on SilverFort-AD (Server 2022 DC, 32GB): eliminates 3 false
sessions while preserving all 10 legitimate ones.
2026-02-25 22:57:09 +01:00
NK 08e95e7a82 Bump version to 0.2.2 2026-02-25 11:31:49 +01:00
NK d262b7fad3 Fix clippy len_zero warning
Use !is_empty() instead of len() >= 1 for clearer intent.
2026-02-25 11:00:52 +01:00
NK e774c481b5 Bump version to 0.2.1 2026-02-25 10:56:04 +01:00
NK 384fdcf191 Add raw file input: vmkatz ntds.dit SYSTEM, vmkatz SAM SYSTEM [SECURITY]
Accept multiple positional arguments and auto-detect file types by magic
bytes (ESE 0xEFCDAB89, registry "regf", minidump "MDMP").

- Raw NTDS.dit + SYSTEM hive: extracts AD hashes without a disk image
- Raw SAM + SYSTEM [+ SECURITY]: extracts local hashes, LSA secrets,
  and cached domain credentials from exported registry hives
- Auto-detects which hive is SYSTEM (bootkey extraction), SAM, or
  SECURITY — argument order does not matter
- Helpful error messages for incomplete inputs (e.g. NTDS without SYSTEM)
- LSASS minidump detection with guidance to use pypykatz (parser planned)
- Full backward compatibility with existing single-file workflows
2026-02-25 10:54:08 +01:00
NK a794c19388 Bump version to 0.2.0 2026-02-25 10:42:16 +01:00
NK b988715864 Add colored output, blank hash detection, and fix LM hash display
- Add --color auto|always|never for colored terminal output (TTY auto-detect)
- Highlight usernames (bold), hashes (yellow), section headers (green),
  provider names (cyan), plaintext passwords (red), blank hashes (dim)
- Annotate well-known blank password hashes with (blank) in text mode
- Hide zero LM hashes in text mode (mimikatz convention: LM disabled)
- Output aad3b435b51404eeaad3b435b51404ee for zero LM in ntlm/csv modes
  (impacket pwdump convention for downstream tool compatibility)
- Add acknowledgements section for mimikatz, pypykatz, and impacket
2026-02-25 10:37:15 +01:00
NK def787cfc4 Add native NTDS.dit extraction with ESE large page support
- Fix ESE parser for 32KB large pages (Win Server 2025): use 80-byte
  page header and 12-bit tag count for pages >=16KB
- Move NTDS code from src/sam/ to src/ntds/ module (ese.rs + mod.rs)
- Enable ntds.dit feature by default in Cargo.toml
- Fix conditional compilation warnings across all feature combinations
- Add test examples for ESE parser and end-to-end NTDS extraction
- Update README with NTDS usage, examples, and test results

Verified against 4 domain controllers:
  - 3x Win Server 2019 (8KB pages, GOAD lab): 18/19/15 hashes
  - 1x Win Server 2025 (32KB pages): 8 hashes
All hashes match impacket-secretsdump (which itself fails on 32KB pages).
2026-02-25 10:02:01 +01:00
NK a5d5b9a875 Add Proxmox Win11 test result to README 2026-02-24 23:03:41 +01:00
NK b241b4e805 Fix DCC2 key offset, GMSA display, and add block device support
- Fix DCC2 cached credentials: use NL$KM[0:16] as AES key instead of
  [16:32]. The secret is already stripped of its LSA_SECRET_BLOB header,
  so [16:32] was a double offset producing garbage decryption.
- Fix GMSA secrets: display managed service account passwords as hex
  instead of trying to decode binary data as UTF-16LE.
- Add raw block device support for LVM thin volumes (/dev/pve/...).
  Auto-detect block devices and route to SAM extraction. Use seek-to-end
  for device size since metadata().len() returns 0 for block devices.
- Update README with Proxmox LVM test results and Server 2025 support.
2026-02-24 23:02:12 +01:00
NK 396817c594 Add Clippy CI workflow and badge 2026-02-19 21:40:31 +01:00
NK 9a08d27c2f Replace static Rust badge with CI build status badge 2026-02-19 21:38:16 +01:00
NK 63d1e1404b Add MIT license, multi-platform CI, and README badges 2026-02-19 21:23:50 +01:00
NK 5e941b3ce3 Update gitignore and README 2026-02-19 21:11:30 +01:00
NK 0cd17ad6d9 Refactor credential extraction pipeline and add README 2026-02-19 19:49:13 +01:00
NK 9df9c2fca2 Add NTDS feature pipeline and release workflow 2026-02-19 16:21:49 +01:00
NK 6120e4a50d Add hashcat output format, flat VMDK support, and EPT walker for VBS VMs
- New --format hashcat: outputs NTLM hashes (mode 1000) and DCC2 (mode 2100)
  for direct use with hashcat
- Raw disk support: handles flat VMDKs (-flat.vmdk) and raw images (.raw/.img/.dd)
  as simple seek+read without sparse container parsing
- EPT walker: scans for nested hypervisor page tables (VBS/Hyper-V) when
  System process not found in L1 physical memory, translates L2→L1 addresses
  through Extended Page Tables to access Windows kernel structures
- Debug logging for System process scan near-misses (DTB/Flink rejections)
2026-02-11 02:19:40 +01:00
NK 5bc7e25a76 Fix MSV NT hash offset: detect DPAPI-shifted layout (NT at 0x4A not 0x36)
Win10 1607+ (build 19045) stores a 20-byte SHA/DPAPI field at +0x36 before
the actual hashes, shifting NtOwfPassword from +0x36 to +0x4A. Previous code
extracted the first 16 bytes of ShaOwPassword instead of the real NT hash.

Changes:
- Add DPAPI-shifted layout detection in structural_score(): compares data at
  0x36 with data at 0x6A (both contain ShaOwPassword/dppiGenericRandom)
- Add 6 PRIMARY_CRED_OFFSET_VARIANTS: canonical mimikatz (0x36, 0x28, 0x20),
  no-unk (0x30), and empirical DPAPI-shifted (0x4A, 0x4C)
- Replace first-match entropy selection with scored candidates, preferring
  variants with highest structural_score()
- When DPAPI layout detected: variant 0x36 gets score=0, variant 0x4A gets
  score=23 (flags validated + zero LM + DPAPI confirmed)

Verified against pypykatz: NT=bbf7d1528afa8b0fdd40a5b2531bbb6d matches
across all 3 VMware snapshots and VBox snapshot.
2026-02-10 20:51:40 +01:00
NK 423d760579 Fix multi-version support: VMware identity mapping, MSV hash validation, Win11 24H2
- VMware layer: fall back to identity mapping when VMSN has no region
  tags (older VMware snapshots), fixes "System process not found" on
  VMs with minimal VMSN metadata

- MSV physical scan: replace broken variant-0 fallback with proper
  entropy-based validation. When SHA1 cross-validation fails for all
  offset variants, check if SHA1 field is zero (not stored on Win7/2012)
  and validate hash bytes don't look like UTF-16 text. Prevents garbage
  hashes (username/domain text displayed as NT hashes) on older builds.

- Add Win11 24H2 (build 26100+) EPROCESS offsets: UniqueProcessId,
  ActiveProcessLinks, ImageFileName shifted +8 from Win10 layout

Tested on ESXi against 12 Windows VMs spanning Win7 through Win11:
  Win7, Win8/2012, Win10, Win11, Server 2012 DC, Server 2016,
  Server 2016 DC, Server 2019
2026-02-10 18:56:16 +01:00
NK f801d4f830 Add QEMU/KVM/Proxmox ELF core dump and Hyper-V .bin support
- New `qemu` feature: ELF64 core dump reader (from dump-guest-memory / virsh dump)
  Parses PT_LOAD segments for GPA→file offset mapping with binary search
- New `hyperv` feature: Hyper-V legacy .bin raw memory reader (identity mapping)
  Also handles raw dumps from MemProcFS export
- Smart format detection: magic-based (ELF header) with extension fallback
  .elf → QEMU, .bin/.raw → auto-detect ELF or Hyper-V, .sav → VBox, else VMware
- Auto-discovery: .elf, .bin, .raw files in folder mode
- Fix MSV physical scan merge: LUID=0 credentials now match existing sessions
  by username+domain instead of all colliding at HashMap key 0
2026-02-10 17:39:37 +01:00
NK dc41b621ff Fill NT AUTHORITY domain for well-known LUID sessions
When WDigest is paged out (common on VBox snapshots), SYSTEM and
service sessions have empty domain. Now fills "NT AUTHORITY" as
domain for LUIDs 0x3e7/0x3e4/0x3e5 when domain is empty, while
preserving WDigest-discovered values (e.g. WORKGROUP) when present.
2026-02-10 15:47:23 +01:00
NK 868137e2a4 Fix clippy warnings: use contains(), fix late initialization 2026-02-10 15:35:47 +01:00
NK 2c4109b8c2 Populate well-known LUID usernames and improve session display
- Fill in SYSTEM/NETWORK SERVICE/LOCAL SERVICE usernames for well-known
  LUIDs when they're empty (common on VBox where WDigest is paged out)
- Ensures DPAPI-only sessions show meaningful identifiers
2026-02-10 15:32:34 +01:00