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
- Demonstration
- Usage
- Usage
- Supporting Materials
- Contributing
- Attribution
- Acknowledments
- License
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
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
| Flag | Description | Default value |
|---|---|---|
| -l, --list | List of target URLs | |
| -c, --concurrency | Set the concurrency level | 5 |
| -t, --timeout | Max. time allowed for connection (s) | 30 |
| -h, --help | Prints help information | |
| -V, --version | Prints version information |
Supporting Materials
- Nuclei templates
- PPScan
- Prototype Pollution and useful Script Gadgets
- JavaScript prototype pollution attack in NodeJS
- Prototype pollution ā and bypassing client-side HTML sanitizers
Contributing
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:
- @mattsse - for his awesome chromiumoxide & mentoring me which helped a lot to quickly adapt Rust!
Fourty2#4842(Discord) - for helpful workaround.- All contributors.
License
ppfuzz is distributed under MIT. See LICENSE.