Skip to content
No description, website, or topics provided.
Python Dockerfile C
Branch: master
Clone or download
Andrea Marcelli
Andrea Marcelli Initial commit
Latest commit 3120197 Sep 5, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
config Initial commit Sep 4, 2019
ghidra_plugins Initial commit Sep 4, 2019
tests Initial commit Sep 4, 2019
.gitignore Initial commit Sep 4, 2019
Dockerfile Initial commit Sep 4, 2019
LICENSE Initial commit Sep 3, 2019
README.md Initial commit Sep 4, 2019
flask_api.py Initial commit Sep 4, 2019
launch.sh.patch Initial commit Sep 4, 2019
requirements.txt Initial commit Sep 4, 2019

README.md

Ghidraaas - Ghidra as a Service

Ghidraaas is a simple web server that exposes Ghidra analysis through REST APIs. The project includes three Ghidra plugins to analyze a sample, get the list of functions and to decompile a function.

Ghidraaas is also the backend of GhIDA, the IDA plugin that integrates the Ghidra decompiler in IDA Pro.

How does it work?

Ghidraaas uses Ghidra Headless Analyzer to analyze the submitted sample. Then, the Ghidra project (the *.gpr file and the *.rep folder) is kept on the server until the analysis_terminated API is called. Three Ghidra Python plugins are called by the Headless Analyzer on the sample's project to extract the list of functions and to decompile the requested function.

Features

Ghidraaas implements generic APIs to analyze a sample, get the list of functions and the decompiled code of a function, but it also includes some specific APIs to interact with the GhIDA plugin.

Ghidraaas generic APIs:

  • api/analyze_sample/ Submit a sample for the analysis

  • api/get_functions_list/<sha256> Request the list of functions

  • api/get_functions_list_detailed/<sha256> Request the list of functions with additional details

  • api/get_decompiled_function/<sha256>/<offset> Request to decompile a function

  • api/analysis_terminated/<sha256> Remove the *.gpr file and *.rep project folder related to the sample.

GhIDA specific APIs:

  • api/ida_plugin_checkin/ Sample check-in

  • api/ida_plugin_get_decompiled_function/ Decompile function

  • api/ida_plugin_checkout/ Sample check-out.

An example on how to use the APIs can be found in test.py.

Installation

Lazy installation with Docker

docker_config.json contains the configuration file of Ghidraaas (no changes are needed).

  • Build ghidraaas
docker build -t ghidraaas .
  • Run ghidraaas docker
docker run -p 8080:8080 -v /home/user/ghidra_projects:/opt/ghidra_projects -t ghidraaas
  • Test the APIs
cd tests
python3 test.py

Manual installation (no docker)

  • Create a Python3 virtual env
python3 -m virtualenv env
source env/bin/activate
  • Install the required packages
pip install -r requirements.txt
  • Download and unzip the latest Ghidra release
wget -O ghidra.zip https://ghidra-sre.org/ghidra_9.0.4_PUBLIC_20190516.zip
unzip ghidra.zip
rm ghidra.zip
  • Set the ghidra_9.x.x folder path in GHIDRA_PATH of config.json

  • Launch the server

gunicorn -w 2 -b 0.0.0.0:8080 flask_api:app
  • Test the APIs Open another terminal and type:
cd tests
python3 test.py

Bugs and suggestion

If you discover a bug, or you have any improvements or suggestions, please open an issue.

Be sure to include as many details as possible in order to reproduce the bug.

License

Ghidraaas is licensed under the Apache License 2.0

The original Dockerfile and launch.sh.patch are from bskaggs/ghidra-docker.

You can’t perform that action at this time.