Home

Awesome

ppfuzz

<p align="left"> <a href="https://www.rust-lang.org/"><img src="https://img.shields.io/badge/made%20with-Rust-red"></a> <a href="#"><img src="https://img.shields.io/badge/platform-osx%2Flinux%2Fwindows-blueviolet"></a> <a href="https://github.com/dwisiswant0/ppfuzz/releases"><img src="https://img.shields.io/github/release/dwisiswant0/ppfuzz?color=blue"></a> <a href="https://github.com/dwisiswant0/ppfuzz/issues"><img src="https://img.shields.io/github/issues/dwisiswant0/ppfuzz?color=yellow"></a> </p>

Prototype Pollution Fuzzer

<img src="https://user-images.githubusercontent.com/25837540/124197070-f0ffb800-daf7-11eb-9d65-edda5d94633f.jpg" alt="ppfuzz, Prototype Pollution Fuzzer">

A fast tool to scan client-side prototype pollution vulnerability written in Rust. šŸ¦€


Installation

Binary

Simply, download a pre-built binary from releases page and run!

Source

<table> <td><b>NOTE:</b> <a href="https://www.rust-lang.org/tools/install">Rust</a> should be installed!</td> </table>

Using cargo:

ā–¶ cargo install ppfuzz

ā€” or

Manual building executable from source code:

ā–¶ git clone https://github.com/dwisiswant0/ppfuzz
ā–¶ cd ppfuzz && cargo build --release
# binary file located at target/release/ppfuzz

Dependencies

ppfuzz uses chromiumoxide, which requires Chrome or Chromium browser to be installed. If the CHROME environment variable is set, then it'll use it as the default executable. Otherwise, the filenames google-chrome-stable, chromium, chromium-browser, chrome and chrome-browser are searched for in standard places. If that fails, /Applications/Google Chrome.app/... (on MacOS) or the registry (on Windows) is consulted.

Demonstration

ppfuzz-demonstration

As you can see in the demo above (click to view in high-quality), ppfuzz attempts to check for prototype-pollution vulnerabilities by adding an object & pointer queries, if it's indeed vulnerable: it'll fingerprinting the script gadgets used and then display additional payload info that could potentially escalate its impact to XSS, bypass or cookie injection.

Usage

It's fairly simple to use ppfuzz!

ā–¶ ppfuzz -l FILE [OPTIONS]

Basic

Use -l/--list to provide input list:

ā–¶ ppfuzz -l FILE

You can also provide the list using I/O redirection:

ā–¶ ppfuzz < FILE

ā€” or chain it from another command output:

ā–¶ cat FILE | ppfuzz

Only show vulnerable targets/suppress an errors:

ā–¶ ppfuzz -l FILE 2>/dev/null

Options

Here are all the options it supports:

ā–¶ ppfuzz -h
FlagDescriptionDefault value
-l, --listList of target URLs
-c, --concurrencySet the concurrency level5
-t, --timeoutMax. time allowed for connection (s)30
-h, --helpPrints help information
-V, --versionPrints version information

Supporting Materials

Contributing

contributions

When I started ppfuzz, I had very little or no knowledge on Rust and I believe there may be a lot of drawbacks/security vulnerabilities. So all contributions are welcome, of course ā€” any bug reports & suggestions are appreciated, some environment have not been tested yet.

Attribution

Besides being my learning medium, this tool was created because it was inspired by @R0X4R's tip on how to automate prototype pollution checking using page-fetch.

Cross-compile GitHub workflow inspired by crodjer's sysit.

Acknowledments

Since this tool includes some contributions, I'll publically thank the following users for their helps and resources:

License

ppfuzz is distributed under MIT. See LICENSE.