To help you get started with angr, we've created several examples. These mostly stem from CTF problems solved with angr by Shellphish. Enjoy!
This is a basic script that explains how to use angr to symbolically execute a program and produce concrete input satisfying certain conditions.
Binary, source, and script are found here.
author: Stanislas Lejay (github: @P1kachu)
Script runtime: ~31 minutes
Here is the binary and the script
Script author: chuckleberryfinn (github: @chuckleberryfinn)
Script runtime: ~20 seconds
A simple reverse me that takes a key as a command line argument and checks it against 14 checks. Possible to solve the challenge using angr without reversing any of the checks.
Here is the binary and the script
-
Script 0
author: David Manouchehri (github: @Manouchehri)
Script runtime: 8 minutes
-
Script 1
author: Stanislas Lejay (github: @P1kachu)
Script runtime: 11 sec
Here is the binary and the scripts:
Script 0 author: David Manouchehri (github: @Manouchehri)
Script runtime: 4.5 sec
Script 1 author: Adam Van Prooyen (github: @docileninja)
Script runtime: 6.7 sec
A Linux binary that takes a key as a command line argument and check it against a series of constraints.
Challenge Description:
We need help activating this product -- we've lost our license key :(
You're our only hope!
Here are the binary and scripts: script 0, script_1
Author: Fish Wang (github: @ltfish)
Script runtime: 5.5 sec
A Windows binary that takes a flag as argument, and tells you if the flag is correct or not.
"I have to patch out some checks that are difficult for angr to solve (e.g., it uses some bytes of the flag to decrypt some data, and see if those data are legit Windows APIs). Other than that, angr works really well for solving this challenge."
Author: Fish Wang (github: @ltfish)
Script runtime: 5.5 sec
This is a painful challenge to solve with angr. I should have done things in a smarter way.
Here is the binary and the script.
Author: Fish Wang (github: @ltfish)
Script runtime: 1 min 57 sec
The solution is pretty straight-forward.
Author: Fish Wang (github: @ltfish)
Script runtime: 3.6 sec
This is a good example that showcases the following:
- Create a custom file, and load it during symbolic execution.
- Create an inline call to SimProcedure
strlen, and use it to determine the length of a string in memory - even if the string may not be null-terminated. LAZY_SOLVESshould be disabled sometimes to avoid creating too many paths.
Here are the binary and the script.
Author: Fish Wang (github: @ltfish)
angr solves this challenge with almost zero user-interference.
See the script and the binary.
Author: Fish Wang (github: @ltfish)
angr solves this challenge with almost zero user-interference. Veritesting is required to retrieve the flag promptly.
The script and the binary. It takes a few minutes to run on my laptop.
Author: Andrew Dutcher (github: @rhelmot)
We solved this simple reversing challenge with angr, since we were too lazy to reverse it or run it in Windows. The resulting script shows how we grabbed the flag out of the DLL.
Author: Chris Salls (github: @salls)
This crackme is 95% solveable with angr, but we did have to overcome some difficulties. The script describes the difficulties that were encountered and how we worked around them. The binary can be found here.
Author: Fish Wang (github: @ltfish)
angr acts as a binary loader and an emulator in solving this challenge. I didn’t have to load the driver onto my Windows box.
The script demonstrates how to hook at arbitrary program points without affecting the intended bytes to be executed (a zero-length hook). It also shows how to read bytes out of memory and decode as a string.
By the way, here is the link to the intended solution from FireEye.
Author: Chris Salls (github: @salls)
This reversing challenge is simple to solve almost entirely with angr, and a lot faster than trying to reverse the password checking function. The script is here
Author: Adrian Tang (github: @tangabc)
Script runtime: 2 mins 10 secs
This is another reversing challenge from the FlareOn challenges.
"The challenge is designed to teach you about PCAP file parsing and traffic decryption by reverse engineering an executable used to generate it. This is a typical scenario in our malware analysis practice where we need to figure out precisely what the malware was doing on the network"
For this challenge, the author used angr to represent the desired encoded output as a series of constraints for the SAT solver to solve for the input.
For a detailed write-up please visit the author's post here and you can also find the solution from the FireEye here
Author: Fish Wang (github: @ltfish), ocean (github: @ocean1)
This challenge is a movfuscated binary. To find the correct password after exploring the binary with Qira it is possible to understand how to find the places in the binary where every character is checked using capstone and using angr to load the binary and brute-force the single characters of the flag. Be aware that the script is really slow. Runtime: > 1 hour.
Author: WGH ([email protected])
Script runtime: 1 min 50 secs (CPython 2.7.10), 1 min 12 secs (PyPy 4.0.1)
In this challenge we're given a text file with trace of a program execution. The file has two columns, address and instruction executed. So we know all the instructions being executed, and which branches were taken. But the initial data is not known.
Reversing reveals that a buffer on the stack is initialized with known constant string first, then an unknown string is appended to it (the flag), and finally it's sorted with some variant of quicksort. And we need to find the flag somehow.
angr easily solves this problem. We only have to direct it to the right direction at every branch, and the solver finds the flag at a glance.
Author: Fish Wang (github: @ltfish)
We solved this crackme with angr’s help. (Fish: This is my first time solving a reversing challenge without understanding what’s going on.) The challenge binary is here, and the solving script here.
The solving script demonstrates the following:
- How to load a Windows binary (no difference than an ELF).
- How to use hook to replace arbitrary code in a loaded program.
- How to use Explorer to perform a symbolic exploration (although everyone else thinks PathGroup is the future).
- How to enable Veritesting, and why it is useful.
Author: Yan Shoshitaishvili (github: @Zardus)
We solved this crackme with angr's help. The resulting script will help you understand how angr can be used for crackme assistance. You can find this script here and the binary here.
Author: Andrew Dutcher (github: @rhelmot)
angr can outright solve this challenge with very little assistance from the user. The script to do so is here and the binary is here.
Author: Andrew Dutcher (github: @rhelmot)
angr cannot currently solve this problem natively, as the problem is too complex for z3 to solve. Formatting the constraints to z3 a little differently allows z3 to come up with an answer relatively quickly. (I was asleep while it was solving, so I don't know exactly how long!) The script for this is here and the binary is here.
Author: Antonio Bianchi, Tyler Nighswander
ais3_crackme has been developed by Tyler Nighswander (tylerni7) for ais3 summer school. It is an easy crackme challenge, checking its command line argument.
Author: David Manouchehri (GitHub @Manouchehri)
This folder contains scripts used to solve some of the challenges with angr. At the moment it only contains the examples from the IOLI crackme suite, but eventually other solutions will be added.
Author: Kyle Ossinger (github: @k0ss)
This is the first in a series of "tutorial scripts" I'll be making which use angr to find exploitable conditions in binaries.
The first example is a very simple program.
The script finds a path from the main entry point to strcpy, but only when we control the source buffer of the strcpy operation.
To hit the right path, angr has to solve for a password argument, but angr solved this in less than 2 seconds on my machine using the standard python interpreter.
The script might look large, but that's only because I've heavily commented it to be more helpful to beginners.
The challenge binary is here and the script is here.
Author: Antonio Bianchi, Jacopo Corbetta
This is a very easy binary containing a stack buffer overflow and an easter egg. CADET_00001 is one of the challenge released by DARPA for the Cyber Grand Challenge: link The binary can run in the DECREE VM: link CADET_00001.adapted (by Jacopo Corbetta) is the same program, modified to be runnable in an Intel x86 Linux machine.
Author: Andrew Dutcher (github: @rhelmot)
This is the demonstration presented at 32c3. The script uses angr to discover the input to crash grub's password entry prompt.
Author: Nick Stephens (github: @NickStephens)
Demonstration for Insomni'hack 2016. The script is a very simple implementation of AEG.