XSRFProbe

The Prime Cross Site Request Forgery Audit & Exploitation Toolkit.

About

XSRFProbe is an advanced Cross Site Request Forgery (CSRF/XSRF) Audit and Exploitation Toolkit. Equipped with a powerful crawling engine and numerous systematic checks, it is able to detect most cases of CSRF vulnerabilities, their related bypasses and futher generate exploitable proof of concepts with each found vulnerability. For more info on how XSRFProbe works, see XSRFProbe Internals on wiki.

XSRFProbe Wiki • Getting Started • General Usage • Advanced Usage • XSRFProbe Internals • Gallery

Some Features

• Runs a full battery of systematic checks — backed by a response diffing/benchmark engine — before declaring an endpoint vulnerable.
• Detects and actively tampers with many Anti-CSRF token implementations: request-method switch, token removal, empty/duplicated values, non-session-bound tokens, double-submit cookies and custom-header tokens.
• Probes Referer and Origin validation with real-world bypasses (header removal, regex/subdomain tricks, Origin: null) as well as method-override and Content-Type bypasses.
• Analyses SameSite cookie protections, with optional subdomain enumeration (via crt.sh) for sibling-domain bypass testing.
• Works with a powerful crawler featuring deterministic, bounded crawling and scanning (configurable via --max-urls, --max-depth and --crawl-timeout).
• Optional headless Firefox (Selenium) integration for browser-dependent tests and auto-validation of generated PoCs.
• Accurate Token-Strength Detection and Analysis using entropy and encoding checks.
• Can generate both normal as well as maliciously exploitable CSRF proof of concepts.
• Out of the box support for custom cookie values, generic headers and a JSON report — each finding carries a severity rating and an exploitability precondition.
• The user is in control of everything whatever the scanner does.
• User-friendly interaction environment with full verbose support and detailed logging of errors, vulnerabilities and tokens.

Vulnerability Tests Performed:

Every check XSRFProbe runs has a unique identifier. The ID is shown in the console output (e.g. [T6] VULNERABLE: ...) and stored as the test_id field of each finding in the JSON report (alongside its severity and, where relevant, an exploitability note under details), so each finding maps back to the exact test that produced it.

S* checks require the optional headless-browser integration (--browser). T*/M*/R*/O* are HTTP-level checks gated by the response diffing/benchmark engine.

Gallery

Lets see some real-world scenarios of XSRFProbe in action:

Installation & Usage

For the full usage info, please take a look at the wiki's — General Usage and Advanced Usage.

Installing via Pypi:

XSRFProbe can be easily installed via a single command:

pip install xsrfprobe

Installing manually:

• For the basics, the first step is to install the tool:

pip install .

• Now, the tool can be fired up via:

xsrfprobe --help

• The browser-dependent tests (--browser, --auto-validate-poc) additionally require geckodriver to be available in your PATH (or pointed to via --geckodriver-path).
• After testing XSRFProbe on a site, an output folder is created in your present working directory as xsrfprobe-output. Under this folder you can view the detailed logs and information collected during the scans (pass --json for a machine-readable report).

Version and License

XSRFProbe is currently v3.0.0 and the work is licensed under the GNU General Public License (GPLv3).

Warnings

Do not use this tool on a live site!

It is because this tool is designed to perform all kinds of form submissions automatically which can sabotage the site. Sometimes you may screw up the database and most probably perform a DoS on the site as well.

Test on a disposable/dummy setup/site!

Disclaimer

Usage of XSRFProbe for testing websites without prior mutual consistency can be considered as an illegal activity. It is the final user's responsibility to obey all applicable local, state and federal laws. The author assumes no liability and is not responsible for any misuse or damage caused by this program.

Author's Words

This project is based entirely upon my own research and my own experience with web applications on Cross-Site Request Forgery attacks. You can try going through the source code to help you understand how this toolkit was built. Useful pull requests, ideas and issues are highly welcome. If you wish to see what how XSRFProbe is being developed, check out the Development Board.

Crafted with ♡ by @0xInfection