0.0
The project is in a healthy, maintained state
Extracting the contents of Microsoft Windows Registry (hive) and display it as a colorful tree but mainly focused on parsing BCD files to extract WIM files path for PXE attacks.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

~> 0.6
~> 2.3
 Project Readme

HivExcavator

GitHub forks GitHub stars GitHub license Rawsec's CyberSecurity Inventory

GitHub commit activity

Extracting the contents of Microsoft Windows Registry (hive) and display it as a colorful tree but mainly focused on parsing BCD files to extract WIM files path for PXE attacks.

What is it?

Microsoft Deployment Toolkit (MDT) (integrated in System Center Configuration Manager (SCCM)) helps to automate the deployment of Windows and to manage OS images.

Some devices load and install the OS directly over a network connection via Preboot Execution Environment (PXE) images managed and hosted by MDT. Devices will ask a PXE configuration over Dynamic Host Configuration Protocol (DHCP) then a Trivial File Transfer Protocol (TFTP) connection is used to retrieve the PXE boot image.

Attackers are mainly interested in PXE boot images for:

  • Modifying the image: injecting an Elevation of Privilege (EoP) vector or backdoor the image to gain administrative access or spy on the compromised host with a Man-in-the-Middle (MitM) attack.
  • Read the image: parsing the image for passwords and secrets.

For the second scenario, the retrieved PXE configuration will give us a list of Boot Configuration Data (BCD) files used by Microsoft's Windows Boot Manager.

Those BCD files are like databases and are using the same format as Windows Registry hives. Parsing the BCD files allows retrieving the path of Windows Imaging Format (WIM) files that are the bootable images (PXE boot images). Indeed, the BCD files retrieved via PXE will only contain the pointers towards WIM files and other stuff like System Deployment Image (SID) files.

Note: TFTP doesn't allow to list available files so one has to know the exact path to retrieve them, that's why parsing the BCD file is required.

After downloading the WIM files, the attack can parse them to retrieve, for example, credentials.

The PowerShell library PowerPXE does all that BUT while most functions (like Get-FindCredentials) work on PowerShell Core (open-source variant of PowerShell that runs on Linux and macOS), some functions like Get-WimFile only work on Windows PowerShell (the closed source variant of PowerShell that runs only on Windows).

Note: Get-WimFile, used to extract WIM file path, uses Common Information Model (CIM) PowerShell module that is available exclusively on Windows.

So while PowerPXE can be used to find and extract credentials from PXE server or detect BCD files on PXE server on Linux and macOS with PowerShell Core, it can't export WIM path from BCD files on those OSes at it can only on Windows.

A Linux and macOS based attacker, certainly don't want to create a Windows Virtual Machine (VM) only to parse a file, that is why HivExcavator is there: to allow you parsing BCD files on Linux and macOS to extract WIM files path.

Prerequisites

Install Hivex (part of libguestfs) because, unfortunately, the library and Ruby wrapper have not been made available as a gem.

Find the name of the package for your distro on Repology.

Installation

Quick installation:

  1. Satisfy the prerequisites
  2. Install the gem
$ gem install hivexcavator

Packaging status Gem Version GitHub tag (latest SemVer)

Example

Example: hivexcavator ~/test/pxe/conf.bcd

Documentation

Author

Made by Alexandre ZANNI (@noraj) at ACCEIS.