/PeachOrchard

Peach Fuzzer Web Frontend

Primary LanguagePythonMIT LicenseMIT

Peach Orchard

Peach Orchard is a web front-end to the Peach fuzzer; it provides a centralized server and distributed nodes that centralizes all crash and status information. Each system that runs Peach can fire up an Orchard node that will send crash information back to the mothership, which will then be viewable from the web interface. If you happen to run a dozen or so fuzzers like I do, this is a nice way to pull that information together to quickly check for any crashes.

I'm bad at web design and have implemented a simple Django app with Bootstrap3; if you're a web guy who likes doing web things, I'd love PRs.

This is similar iSEC's PeachFarmer project, but whilst that only aggregates logs, this provides a way of viewing the data. Also has the added benefit of not opening up ports on all your fuzzing machines; Peach Orchard follows a strict push-only architecture, in which all fuzzers push data up to the core server; one IP, one port.

Requirements

Server & Node

  • Python >= 2.7.x (tested on 2.7.3)

Server:

  • Django >= 1.6.x (tested on 1.6.5)

Node:

  • Requests >= 2.2.x (tested on 2.2.3)

Tested on both Windows and Linux.

Action

Home Page Home

Node View Node

Crash View Crash

Setup

Pretty simple, really. Fundamentally there are two bits of information a Peach Orchard node needs: one, how and where nodes communicate, and what nodes monitor. The how and where can be configured in src/core/config.py by setting the following:

  • SERVER_KEY
    -- This is the shared key needed to authenticate a node with a server. On initial setup, the server will generate secret_key.py, which contains your randomly generated 64 byte PSK. Paste this into here.

  • SERVER_IP
    -- Location of the core server, naturally.

  • MONITOR_DIR
    -- Absolute path to your Peach Logs directory. Please keep this as a raw string, otherwise it'll be angry with your Windows paths.

TODO

  • Beef up node logging
  • Add fuzzing-specific node information to the home page
  • Add support for other fuzzers?
  • Windows cmd colors
  • User authentication
  • Node session management (i.e. managing one node's successive fuzzing campaigns)
  • !?