Skip to content

JWT Analyzer is a powerful Caido plugin designed to help security professionals analyze and assess JWT tokens in real-time.

License

Notifications You must be signed in to change notification settings

amrelsagaei/JWT-Analyzer

Repository files navigation

JWT Analyzer Banner


A powerful plugin for Caido that automatically detects, analyzes, and helps security professionals test JSON Web Tokens (JWTs)



Table of Contents

Overview

JWT Analyzer is a comprehensive security tool designed for penetration testers and web application security professionals. It seamlessly integrates with Caido to provide real-time detection, analysis, and testing capabilities for JSON Web Tokens found in web traffic.

Features

Automatic Token Detection & Analysis
  • Real-time JWT Detection: Automatically identifies and captures JWT tokens in requests and responses
  • Token Security Analysis: Evaluates token security including algorithm strength, signature validation, and claims verification
  • Vulnerability Detection: Identifies common JWT security issues like missing claims, weak algorithms, and token tampering opportunities
Comprehensive Dashboard
  • JWT Summary Statistics: Get at-a-glance view of all detected tokens and critical security issues
  • Algorithm Distribution: Visual breakdown of JWT signing algorithms used across the application
  • Filterable Token List: Sort and filter tokens by severity, algorithm, or source
Advanced JWT Decoder
  • Visual Token Breakdown: See color-coded header, payload, and signature sections
  • Expiration Verification: Visual indicators for token validity status
  • Interactive Claims Explorer: Browse through standard and custom claims with detailed explanations
Security Testing Tools
  • JWT Token Editor: Manipulate token content and sign with different algorithms
  • Attack Simulation Tools: Ready-to-use attacks including algorithm switching, 'none' algorithm, and key injection
  • Key Management: Generate, import and use custom keys for token signing
Detailed Token Analysis
  • Security Risk Assessment: Detailed explanations of token risks and exploitability
  • Claims Validation: Verify critical security claims like 'exp', 'nbf', 'iss', and 'aud'
  • Export Capabilities: Save findings for security reports in different formats
Educational Resources
  • Built-in Documentation: Comprehensive help section with JWT security best practices
  • Testing Workflows: Step-by-step guides for common JWT security testing scenarios
  • References: Links to common JWT vulnerabilities and CVEs

Installation

  1. Open Caido
  2. Navigate to Settings > Plugins
  3. Click the Plugin Store tab
  4. Search for "JWT Analyzer"
  5. Click Install

Usage

Finding JWT Tokens

  1. Start capturing traffic in Caido
  2. Browse through the application while Caido records traffic
  3. JWT Analyzer will automatically detect JWT tokens in requests and responses
  4. Detected tokens will appear in the JWT Analyzer dashboard

Analyzing Tokens

  1. Click on any token in the dashboard to view details
  2. Check the security assessment and identified risks
  3. Review token claims and validate expiration status

Testing for Vulnerabilities

  1. Send a token to the JWT Editor using the "Send to Editor" button
  2. Modify claims or header parameters
  3. Try different attacks like algorithm switching or signature stripping
  4. Use the modified token in your requests to test for vulnerabilities

Security Testing Workflows

Common Attack Scenarios

Attack Description
Algorithm Confusion Switch RS256 to HS256 and use the public key as the HMAC secret
None Algorithm Attack Change the algorithm to 'none' and remove the signature
Key ID (kid) Manipulation Modify the 'kid' parameter to point to a different key
Claim Tampering Modify role claims or user identifiers to test authorization controls

Documentation

Complete documentation is available within the plugin under the Help & Docs tab.

Updates

JWT Analyzer is actively maintained. Updates may include new features, additional attack vectors, and improved token analysis.

Feedback & Issues

If you encounter any issues or have suggestions for improvements, please report them on our GitHub repository.

License

This project is licensed under the MIT License - see the LICENSE file for details.


Made with ❤️ by Amr Elsagaei for the Caido and security community

About

JWT Analyzer is a powerful Caido plugin designed to help security professionals analyze and assess JWT tokens in real-time.

Topics

Resources

License

Stars

Watchers

Forks