https://github.com/galli-leo/emmutaler

A set of tools for fuzzing SecureROM. Managed to find and trigger checkm8.
https://github.com/galli-leo/emmutaler

checkm8 fuzzing ios securerom

Last synced: 21 days ago
JSON representation

A set of tools for fuzzing SecureROM. Managed to find and trigger checkm8.

• Host: GitHub
• URL: https://github.com/galli-leo/emmutaler
• Owner: galli-leo
• Created: 2021-02-23T01:56:14.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2021-09-18T12:55:25.000Z (about 3 years ago)
• Last Synced: 2024-08-05T17:30:42.909Z (4 months ago)
• Topics: checkm8, fuzzing, ios, securerom
• Language: Go
• Homepage:
• Size: 1.71 MB
• Stars: 160
• Watchers: 7
• Forks: 18
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-hacking-lists - galli-leo/emmutaler - A set of tools for fuzzing SecureROM. Managed to find and trigger checkm8. (Go)

README

        
# emmutaler

A set of tools to enable fuzzing of the iPhone boot loader (and much more).

This was developed for my thesis.

For some more information of how certain parts of this work, see [my thesis](docs/thesis.pdf).

I plan on sharing my `*.idb` for the different SecureROMs sometime soon.

Need to first figure out whats the best way to do that :)

I also need to figure out a License for this (not sure if I am using anything that requires me to have a restrictive license).

If you need to use it urgently and are concerned about the license, let me know :)

**Disclaimer:** Everything is as is and will almost certainly not work out of the box.

You will have to change quite a few things to make it run locally.

# Directory Layout

The following is very incomplete, but it should give you an idea on what to look for where.

## go/

Contains the go part of this project.

The go part contains the binary patcher, IMG4 generation and other things such as generating various files for the compilation of the final binary.

It also contains commands to make it easier to run IDA from build scripts.

## python/

Contains the python part of this project.

Almost all python things are used inside IDA.

### python/scripts/

Contains various scripts that are ran inside IDA.

- `coverage.py`: Loads coverage into lighthouse, then creates tikz graphs and latex tables. Beware this is ugly

- `emmu_loader.py`: A SecureROM loader for IDA that works more nicely than what I could find before. Requires the go part of this project however to be ran against the SecureROM beforehand.

- `symbolicate.py`: Exports symbols from IDA into a format that the go part can understand. We can then use these symbols from our C code.

### python/emmutaler/

The python package contain a lot of code used by the scripts.

## src/

Contains the C code that builds to the main binary that will be fuzzed.

Lots of sorcery going on here :)

### src/heap/

Contains the custom heap implementation, FETA.

### src/usb/

Contains a bunch of the USB stuff used for fuzzing USB messages.