https://github.com/IOActive/Platbox

UEFI and SMM Assessment Tool
https://github.com/IOActive/Platbox

Last synced: 9 months ago
JSON representation

UEFI and SMM Assessment Tool

• Host: GitHub
• URL: https://github.com/IOActive/Platbox
• Owner: IOActive
• License: mit
• Created: 2022-10-31T03:05:38.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2024-11-21T21:09:35.000Z (about 1 year ago)
• Last Synced: 2024-11-21T22:21:16.310Z (about 1 year ago)
• Language: Python
• Homepage:
• Size: 1.23 MB
• Stars: 173
• Watchers: 16
• Forks: 27
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome-rainmana - IOActive/Platbox - UEFI and SMM Assessment Tool (Python)

README

          
# Platbox

UEFI and SMM Assessment Tool

## Features

Platbox is a tool that helps assessing the security of the platform:

- Dumps the platform registers that are interesting security-wise

    - Flash Locks

    - MMIO and Remapping Locks

    - SMM Base and Locks

    - MSRs

- RW access to the PCI configuration space of devices.

- RW to physical memory and virtual memory.

- Allows allocating physical memory and map memory to usermode.

- Read and Write MSRs.

- Dump SPI Flash content (BIOS) into a file.

- Basic dumb SMI Fuzzer.

- Dump S3 Bootscript (from SMM-Lockbox) into a file.

- Dump EFI Memory Map (Linux only for now).

- List UEFI variables.

- Supports Linux and Windows.

- Supports Intel and AMD.

### Example of 'chipset' command output for an AMD platform

![Kiku](example_chipset_output_amd.png)

![Kiku](example_chipset_output_amd2.png)

## Project Structure

The project is divided as follows:

- PlatboxDrv: kernel drivers used for Linux and Windows.

- PlatboxLib: the usermode component that loads the kernel driver and provides access to all the previously listed features.

- PlatboxCli: a console client that uses the library.

- Pocs: an example of a program using features from the libary. 

## Compilation Steps

### Windows

```

mkdir build

cd build

cmake -G "Visual Studio 17 2022" -A x64 -S .. -B "build64"

cmake --build build64/ --target platbox_cli

```

#### Release Build

```

cmake -G "Visual Studio 17 2022" -A x64 -S .. -B "build64" 

cmake --build build64/ --target platbox_cli --config Release

```