https://github.com/quarkslab/samsung-trustzone-research

Reverse-engineering tools and exploits for Samsung's implementation of TrustZone
https://github.com/quarkslab/samsung-trustzone-research

bindings emulation exploitation fuzzing kinibi reverse-engineering samsung tooling trustzone

Last synced: about 2 months ago
JSON representation

Reverse-engineering tools and exploits for Samsung's implementation of TrustZone

• Host: GitHub
• URL: https://github.com/quarkslab/samsung-trustzone-research
• Owner: quarkslab
• License: other
• Created: 2019-11-25T10:22:51.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2019-12-16T14:29:44.000Z (about 5 years ago)
• Last Synced: 2024-08-02T02:10:36.799Z (5 months ago)
• Topics: bindings, emulation, exploitation, fuzzing, kinibi, reverse-engineering, samsung, tooling, trustzone
• Language: Python
• Homepage:
• Size: 85.9 KB
• Stars: 145
• Watchers: 12
• Forks: 21
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Security Research on Kinibi

In this repository, you will find the tools that we have developed during our research to help us reverse engineer and also exploit Samsung's implementation of TrustZone, which is based on a Trusted OS called Kinibi.

## Bindings

In the `bindings/` folder, you will find Python bindings for the `libMcClient.so` library that is used to communicate with Trusted Applications and Secure Drivers. They were developed because we found it easier to write our exploits in Python, and they proved especially useful for the exercises given during our training sessions.

## Emulator

In the `emulator/` folder, you will find a Python script that makes use of the [Unicorn](https://www.unicorn-engine.org/) engine to emulate a trustlet. This tool was mainly used to test our exploits as it can print the instructions executed, register values and stack content.

## Fuzzer

In the `fuzzer/` folder, you will find a Python script that makes use of the [`afl-unicorn`](https://github.com/Battelle/afl-unicorn) project to fuzz trustlets. It is heavily based on the emulator. You will need to implement more tlApis/drApis if you intend to do some serious fuzzing.

## Scripts

In the `scripts/` folder, you will find various things:

- `mclf_loader`, a loader for trustlet binaries using the MCLF file format

- `tbase_loader`, a loader that extracts the various components of a SBOOT image

- `find_symbols`, a script that finds and renames the various tlApis/drApis stubs within trustlets

- `find_symbols_mclib`, a script that finds and renames the various tlApis/drApis functions within the McLib

The scripts are available both for IDA Pro and Ghidra, as we wanted our trainees to be able to use a free SRE.

## Tainting

In the `tainting/` folder, you will find a Python script that makes use of [Manticore](https://github.com/trailofbits/manticore) to find vulnerabilities in trustlets using symbolic execution. This was just an experiment, so the script is really basic.

## Contact

- Alexandre Adamski <>

- Joffrey Guilbon <>

- Maxime Peterlin <>