Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/illera88/ponce
IDA 2016 plugin contest winner! Symbolic Execution just one-click away!
https://github.com/illera88/ponce
ida ida-plugin idapro symbolic-execution
Last synced: about 1 month ago
JSON representation
IDA 2016 plugin contest winner! Symbolic Execution just one-click away!
- Host: GitHub
- URL: https://github.com/illera88/ponce
- Owner: illera88
- License: other
- Created: 2016-07-02T03:48:56.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-09-03T21:17:40.000Z (2 months ago)
- Last Synced: 2024-10-09T14:02:36.595Z (about 1 month ago)
- Topics: ida, ida-plugin, idapro, symbolic-execution
- Language: C++
- Homepage: https://docs.idaponce.com
- Size: 332 MB
- Stars: 1,479
- Watchers: 74
- Forks: 70
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
README
# Ponce
Ponce \(pronounced _\[ 'poN θe \]_ pon-they \) is an IDA Pro plugin that provides users the ability to perform taint analysis and symbolic execution over binaries in an easy and intuitive fashion. With Ponce you are one click away from getting all the power from cutting edge symbolic execution. Entirely written in C/C++.
### Why?
Symbolic execution is not a new concept in the security community. It has been around for many years but it is not until around 2015 that open source projects like [Triton](https://github.com/JonathanSalwan/Triton) and [Angr](http://angr.io/) have been created to address this need. Despite the availability of these projects, end users are often left to implement specific use cases themselves.
We addressed these needs by creating Ponce, an IDA plugin that implements symbolic execution and taint analysis within the most used disassembler/debugger for reverse engineers.
### Installation
Ponce works with both x86 and x64 binaries in any IDA version >= 7.0. Installing the plugin is as simple as copying the appropiate files from the [latest builds](https://github.com/illera88/Ponce/releases/latest) to the `plugins\` folder in your IDA installation directory.
Make sure you use the Ponce binary compiled for your IDA version to avoid any incompatibilities.
### OS Support
Ponce works on Windows, Linux and OSX natively!
### Use cases
* **Exploit development**: Ponce can help you create an exploit in a far more efficient manner as the exploit developer may easily see what parts of memory and which registers you control, as well as possible addresses which can be leveraged as ROP gadgets.
* **Malware Analysis**: Another use of Ponce is related to malware code. Analyzing the commands a particular family of malware supports is easily determined by symbolizing a simple known command and negating all the conditions where the command is being checked.
* **Protocol Reversing**: One of the most interesting Ponce uses is the possibility of recognizing required magic numbers, headers or even entire protocols for controlled user input. For instance, Ponce can help you to list all the accepted arguments for a given command line binary or extract the file format required for a specific file parser.
* **CTF**: Ponce speeds up the process of reverse engineer binaries during CTFs. As Ponce is totally integrated into IDA you don't need to worry about setup timing. It's ready to be used!
The plugin will automatically run, guiding you through the initial configuration the first time it is run. The configuration will be saved to a configuration file so you won't have to worry about the config window again.
### Use modes
* **Tainting engine**: This engine is used to determine at every step of the binary's execution which parts of memory and registers are controllable by the user input.
* **Symbolic engine**: This engine maintains a symbolic state of registers and part of memory at each step in a binary's execution path.
### Examples
#### Negate and inject a condition
In the next gif we can see the use of automatic tainting and how we can negate a condition and inject it in memory while debugging:
* We select the symbolic engine and set the option to symbolize `argv`.
* We identify the condition that needs to be satisfied to win the crackMe.
* We negate an inject the solution everytime a byte of our input is checked against the key.
* Finally we get the key `elite` that has been injected in memory and therefore reach the `Win` code.
The crackme source code can be found [here](https://github.com/illera88/Ponce/blob/master/examples/crackme_xor.cpp)
#### Using the tainting engine to track user controlled input
In this example we can see the use of the tainting engine with cmake. We are:
* Passing a file as argument to cmake to have him parsing it.
* We select we want to use the tainting engine
* We taint the buffer that \`\`\`fread\(\)\`\`\`\` reads from the file.
* We resume the execution under the debugger control to see where the taint input is moved to.
* Ponce will rename the tainted functions. These are the functions that somehow the user has influence on, not the simply executed functions.
#### Use Negate, Inject & Restore
In the next example we are using the snapshot engine:
* Passing a file as argument.
* We select we want to use the symbolic engine.
* We taint the buffer that \`\`\`fread\(\)\`\`\`\` reads from the file.
* We create a snapshot in the function that parses the buffer read from the file.
* When a condition is evaluated we negate it, inject the solution in memory and restore the snapshot with it.
* The solution will be "valid" so we will satisfy the existent conditions.
 The example source code can be found [here](https://github.com/illera88/Ponce/blob/master/examples/fread_SAGE.cpp)
### Usage
In this section we will list the different Ponce options as well as keyboard shortcuts:
* Access the configuration and taint/symbolic windows: Edit > Ponce > Show Config \(Ctl+Shift+P and Ctl+Alt+T\)
* Enable/Disable Ponce tracing \(Ctl+Shift+E\)
* Symbolize/taint a register \(Ctl+Shift+R\)
* Symbolize/taint memory. Can be done from the IDA View or the Hex View \(Ctl+Shift+M\)
* Solve formula \(Ctl+Shift+S\)
* Negate & Inject \(Ctl+Shift+N\)
* Negate, Inject & Restore Snaphot \(Ctl+Shift+I\)
* Create Execution Snapshot \(Ctl+Shift+C\)
* Restore Execution Snapshot \(Ctl+Shift+S\)
* Delete Execution Snapshot \(Ctl+Shift+D\)
* Execute Native \(Ctl+Shift+F9\)
### Triton
Ponce relies on the [Triton framework](https://github.com/JonathanSalwan/Triton) to provide semantics, taint analysis and symbolic execution. Triton is an awesome Open Source project sponsored by Quarkslab and maintained mainly by [Jonathan Salwan](http://shell-storm.org/) with a rich library. We would like to thank and endorse Jonathan's work with Triton. You rock! :\)
### Building
Since Ponce v0.3 we have moved the building compilation process to use `CMake`. Doing this we unify the way that configuration and building happens for Linux, Windows and OSX. We now support providing feedback on the pseudocode about symbolic or taint instructions. For this feature to work you need to add `hexrays.hpp` to your IDA SDK include folder. `hexrays.hpp` can be found on `plugins/hexrays_sdk/` on your IDA installation path. If you have not purchased the hex-rays decompiler you can still build Pnce by using `-DBUILD_HEXRAYS_SUPPORT=OFF`. We use Github actions as our CI environment. Check the [action files](https://github.com/illera88/Ponce/tree/master/.github/workflows) if you want to understand how the building process happens.
### FAQ
#### Why the name of Ponce?
Juan Ponce de León \(1474 – July 1521\) was a Spanish explorer and conquistador. He discovered Florida in the United States. The IDA plugin will help you discover, explore and hopefully conquer the different paths in a binary.
#### Can Ponce be used to analyze Windows, OS X and Linux binaries?
Yes, you can natively use Ponce in IDA for Windows or remotely attach to a Linux or OS X box and use it. In the next Ponce version we will natively support Ponce for Linux and OS X IDA versions.
#### How many instructions per second can handle Ponce?
In our tests we reach to process 3000 instructions per second. We plan to use the PIN tracer IDA offers to increase the speed.
#### Something is not working!
Open an [issue](https://github.com/illera88/Ponce/issues), we will solve it ASAP ;\)
#### I love your project! Can I collaborate?
Sure! Please do pull requests and work in the opened issues. We will pay you in beers for help ;\)
### Limitations
Concolic execution and Ponce have some problems:
* Symbolic memory load/write: When the index used to read a memory value is symbolic like in `x = aray[symbolic_index]` some problems arise that could lead on the loose of track of the tainted/symbolized user controled input.
* Triton doesn't work very well with [floating point instructions](https://github.com/illera88/Ponce/issues/59).
* Concolic execution only analyzed the executed instructions. That means that symbolic tracking is lost in cases like the following:
```c
int check(char myinput) // Input is symbolic/tainted
{
int flag = 0;
if (myinput == 'A') //This condition is symbolic/tainted
flag = 1
else
flag =- 1;
return flag; // flag is not symbolic/tainted!
}
```
### Authors
* Alberto Garcia Illera \([@algillera](https://twitter.com/algillera)\) [email protected]
* Francisco Oca \([@francisco\_oca](https://twitter.com/francisco_oca)\) [email protected]