Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/0xInfection/XSRFProbe

The Prime Cross Site Request Forgery (CSRF) Audit and Exploitation Toolkit.
https://github.com/0xInfection/XSRFProbe

audit crafted-tokens crawler csrf csrf-attacks csrf-poc csrf-scanner csrf-tokens spider token-generation xsrf

Last synced: about 1 month ago
JSON representation

The Prime Cross Site Request Forgery (CSRF) Audit and Exploitation Toolkit.

Awesome Lists containing this project

README 

        


  


  xsrfprobe

  


  


  XSRFProbe



The Prime Cross Site Request Forgery Audit & Exploitation Toolkit.


  

  

    

  

  

    

  

  

    

   

  

    

  




### About:

__XSRFProbe__ is an advanced [Cross Site Request Forgery](https://www.owasp.org/index.php/Cross-Site_Request_Forgery_(CSRF)) (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 (maliciously) exploitable proof of concepts with each found vulnerability. For more info on how XSRFProbe works, see [XSRFProbe Internals](https://github.com/0xInfection/XSRFProbe/wiki#xsrfprobe-internals) on [wiki](https://github.com/0xInfection/XSRFProbe/wiki/). 



xsrf-logo



  XSRFProbe Wiki •

  Getting Started •

  General Usage •

  Advanced Usage •

  XSRFProbe Internals •

  Gallery




### Some Features:



- [x] Performs [several types of checks](https://github.com/0xInfection/XSRFProbe/wiki/XSRFProbe-Internals#types-of-checks) before declaring an endpoint as vulnerable.

- [x] Can detect several types of Anti-CSRF tokens in POST requests.

- [x] Works with a powerful crawler which features continuous crawling and scanning.

- [x] Out of the box support for custom cookie values and generic headers.

- [x] Accurate [Token-Strength Detection](https://github.com/0xInfection/XSRFProbe/wiki/XSRFProbe-Internals#token-randomness-calculation) and [Analysis](https://github.com/0xInfection/XSRFProbe/wiki/XSRFProbe-Internals#post-scan-token-analysis) using various algorithms.

- [x] Can generate both normal as well as maliciously exploitable CSRF proof of concepts.

- [x] Well [documented code](https://github.com/0xInfection/XSRFProbe/tree/master?files=1) and [highly generalised automated workflow](https://github.com/0xInfection/XSRFProbe/wiki#xsrfprobe-internals).

- [x] The user is in [control of everything](https://github.com/0xInfection/XSRFProbe/wiki/Advanced-Usage#xsrfprobe-configuration-variables) whatever the scanner does.

- [x] Has a user-friendly interaction environment with full verbose support.

- [x] Detailed logging system of errors, vulnerabilities, tokens and other stuffs.



### Gallery:

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










### Usage:

> For the full usage info, please take a look at the wiki's — [General Usage](https://github.com/0xinfection/xsrfprobe/wiki/general-usage) and [Advanced Usage](https://github.com/0xinfection/xsrfprobe/wiki/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:

```

python3 setup.py install

```

- Now, the tool can be fired up via:

```

xsrfprobe --help

```

- 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.



### Version and License:

XSRFProbe `v2.3` release is a `Stage 5 Production-Ready (Stable)` release and the work is licensed under the [GNU General Public License (GPLv3)](https://www.gnu.org/licenses/gpl-3.0.en.html).



### 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 exclusively 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 which is highly documented to help you understand how this toolkit was built. Useful [pull requests](https://github.com/0xInfection/XSRFProbe/wiki/Contributing), [ideas and issues](https://github.com/0xInfection/XSRFProbe/wiki/Reporting-Bugs#before-submitting) are highly welcome. If you wish to see what how XSRFProbe is being developed, check out the [Development Board](https://github.com/0xInfection/XSRFProbe/projects/1).



> Copyright © [@0xInfection](https://www.twitter.com/0xInfection)