> _ jwt_tool.py _ is a toolkit for validating, forging and cracking JWTs (JSON Web Tokens).
Its functionality includes:
This tool is written for pentesters , who need to check the strength of the tokens in use, and their susceptibility to known attacks.
It may also be useful for developers who are using JWTs in projects, but would like to test for stability and for known vulnerabilities, when using forged tokens.
This tool is written natively in Python 2.x using the common libraries.
Customised wordlists are recommended for the Dictionary Attack option.
_ As a speed reference, an Intel i5 laptop can test ~1,000,000 passwords per second on HMAC-SHA256 signing. YMMV. _
Installation is just a case of downloading the
jwt_tool.py file (or
git clone ing the repo).
chmod the file too if you want to add it to your _ $PATH _ and call it from anywhere.)
$ python jwt_tool.py <JWT> (filename)
The first argument should be the JWT itself, followed by a filename/filepath (for cracking the token, or for use as a key file).
$ python jwt_tool.py eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJsb2dpbiI6InRpY2FycGkifQ.aqNCvShlNT9jBFTPBpHDbt2gBB1MyHiisSDdp8SQvgw /usr/share/wordlists/rockyou.txt
The toolkit will validate the token and list the header and payload values.
It will then provide a menu of your available options.
_ Note: _ signing the token is currently supported using HS256, HS384, HS512 algorithms
Input is in either standard or url-safe JWT format, and the resulting tokens are output in both formats for your ease of use.
A lot of the inspiration for this tool comes from the vulnerabilities discovered by Tim McLean.
Check out his blog on JWT weaknesses here: https://auth0.com/blog/critical-vulnerabilities-in-json-web-token-libraries/
My introduction to using this toolkit, and a bit of the history behind it can be found on my blog - https://www.ticarpi.com/introducing-jwt-tool/
A whole bunch of exercises (7 at time of writing) for testing JWT vulnerabilities are provided by Pentesterlab . I'd highly recommend a PRO subscription if you are interested in Web App Pentesting.
Regex for finding JWTs in Burp Search
_ (make sure 'Case sensitive' and 'Regex' options are ticked) _
[= ]ey[A-Za-z0-9_-]*\.[A-Za-z0-9._-]* - url-safe JWT version
[= ]ey[A-Za-z0-9_\/+-]*\.[A-Za-z0-9._\/+-]* - all JWT versions (higher possibility of false positives)