Bolt - CSRF Scanning Suite

Bolt is in beta phase of development which means there can be bugs. Any production use of this tool discouraged. Pull requests and issues are welcome. I also suggest you to put this repo on watch if you are interested in it.

Workflow

Crawling

Bolt crawls the target website to the specified depth and stores all the HTML forms found in a database for further processing.

Evaluating

In this phase, Bolt finds out the tokens which aren't strong enough and the forms which aren't protected.

Comparing

This phase focuses on detection on replay attack scenarios and hence checks if a token has been issued more than one time. It also calculates the average levenshtein distance between all the tokens to see if they are similar.

Tokens are also compared against a database of 250+ hash patterns.

Observing

In this phase, 100 simultaneous requests are made to a single webpage to see if same tokens are generated for the requests.

Testing

This phase is dedicated to active testing of the CSRF protection mechanism. It includes but not limited to checking if protection exsists for moblie browsers, submitting requests with self-generated token and testing if token is being checked to a certain length.

Analysing

Various statistical checks are performed in this phase to see if the token is really random. Following tests are performed during this phase

Monobit frequency test

Block frequency test

Runs test

Spectral test

Non-overlapping template matching test

Overlapping template matching test

Serial test

Cumultative sums test

Aproximate entropy test

Random excursions variant test

Linear complexity test

Longest runs test

Maurers universal statistic test

Random excursions test

Usage
Scanning a website for CSRF using Bolt is as easy as doing

python3 bolt.py -u https://github.com -l 2

Where -u is used to supply the URL and -l is used to specify the depth of crawling.
Other options and switches:

-t number of threads

--delay delay between requests

--timeout http request timeout

--headers supply http headers

Credits
Regular Expressions for detecting hashes are taken from hashID.
Bit level entropy tests are taken from highfestiva's python implementation of statistical tests.