Skip to content

snorelax08/Quantum-Resistance-Checker

BranchesTags

Repository files navigation

⚛️ Quantum Resistance Checker

demo.mp4

Project Overview

Quantum Resistance Checker is a comprehensive cryptographic security analysis tool designed to evaluate encrypted files and assess their vulnerability to quantum computer attacks. The project consists of two complementary applications: a professional Python desktop application and a modern web-based interface.

This tool helps users understand the quantum computing threat to current encryption standards and provides recommendations for migration to post-quantum cryptographic algorithms.

Table of Contents

  1. Project Description
  2. Technologies Used
  3. Key Concepts
  4. System Architecture
  5. Installation & Setup
  6. How to Use
  7. Scoring Methodology
  8. Files Included
  9. Features
  10. Future Enhancements

Project Description

Problem Statement

Quantum computers pose a significant threat to current encryption methods. Algorithms like RSA and ECC, which are widely used today, can be broken by quantum computers using Shor's algorithm. This project aims to:

  • Analyze encrypted files for quantum vulnerability
  • Provide security scores based on encryption algorithms
  • Recommend migration paths to post-quantum cryptography
  • Educate users about quantum computing threats

Solution

The Quantum Resistance Checker provides two user interfaces:

  1. Python Desktop Application - Professional GUI for detailed analysis
  2. Web Application - Modern, interactive interface accessible in any browser

Both applications use the same core analysis engine to evaluate files and provide actionable security recommendations.

Technologies Used

Backend (Python Application)

Languages

  • Python 3.8+ - Primary programming language for the desktop application

Libraries & Frameworks

tkinter              - GUI framework (built-in with Python)
pycryptodome        - Cryptographic functions
python-magic        - File type detection
os                  - File operations
json                - Data handling

Installation

pip install pycryptodome
pip install python-magic

Frontend (Web Application)

Technologies

  • HTML5 - Markup structure
  • CSS3 - Styling and animations
  • JavaScript (Vanilla) - Interactivity and logic
  • No frameworks required - Pure vanilla JavaScript for simplicity

Web Version Features

The web application is a single HTML file that runs directly in any modern browser:

  • Chrome 90+
  • Firefox 88+
  • Safari 14+
  • Edge 90+

Key Concepts

1. Quantum Computing Threat

What is the problem?

  • Current encryption (RSA, ECC) relies on mathematical problems that are hard for classical computers
  • Quantum computers can solve these problems using Shor's algorithm
  • Estimated timeline: Quantum computers capable of breaking RSA by 2030-2040

Why it matters?

  • Encrypted data today can be stored and decrypted by quantum computers in the future
  • "Harvest now, decrypt later" attacks are a real threat

2. Post-Quantum Cryptography

What is it? Encryption algorithms designed to resist quantum attacks. NIST has standardized:

  • KYBER - Key Encapsulation Mechanism (replaces RSA/ECC for key exchange)
  • DILITHIUM - Digital Signature Algorithm (replaces RSA/ECC for signing)
  • FALCON - Compact digital signatures

Why use them?

  • Mathematically hard for both classical AND quantum computers
  • NIST-standardized and peer-reviewed
  • Ready for implementation today

3. File Analysis Approach

The tool analyzes encrypted files by examining:

  1. File Extension - Identifies algorithm from file type
  2. File Size - Estimates key length and encryption strength
  3. File Content - Measures entropy (randomness) to confirm encryption
  4. Metadata - Detects key management practices

4. Scoring System

Total Score: 0-100

Components (weighted):

  • Algorithm Score (30%) - Type of encryption used

    • AES: 28/30 (quantum-safe)
    • RSA: 8/30 (vulnerable)
    • Post-Quantum: 30/30 (best)

  • Key Length Score (40%) - Strength of encryption keys

    • Longer keys = higher scores
    • Proper key management = bonus points

  • File Type Score (20%) - Modernness of encryption format

    • Modern formats (.7z, .gpg): 18/20
    • Legacy formats (.rar, .pem): 10/20

  • Entropy Score (10%) - Randomness of encrypted data

    • High entropy = properly encrypted

Risk Levels:

  • 🟢 Low Risk (80-100): Excellent quantum resistance
  • 🟡 Medium Risk (60-80): Good quantum resistance
  • 🟠 High Risk (40-60): Vulnerable but acceptable
  • 🔴 Critical Risk (0-40): Very vulnerable to quantum attacks

System Architecture

Python Desktop Application Structure

QuantumChecker/
├── main.py                      # Main GUI application
├── quantum_scorer.py            # Analysis engine
├── quantum_recommendations.py   # Recommendations engine
├── requirements.txt             # Dependencies
└── README.md                    # Documentation

main.py

  • Purpose: Tkinter GUI interface
  • Functions:
    • select_file() - File selection dialog
    • analyze_file() - Single file analysis
    • analyze_multiple_files() - Batch analysis
    • show_recommendations() - Display security advice
    • save_results() - Export analysis to file

quantum_scorer.py

  • Purpose: Core analysis logic
  • Functions:
    • analyzeFile(fileName) - Analyze single file
    • score_by_algorithm(algorithm) - Algorithm scoring
    • score_by_key_length(fileSize, fileExtension) - Key strength scoring
    • score_by_file_type(fileExtension) - Format scoring
    • calculate_quantum_vulnerability_score(filePath) - Main scoring function
  • Database: ENCRYPTION_DATABASE - 20+ file types with encryption info

quantum_recommendations.py

  • Purpose: Generate security recommendations
  • Functions:
    • get_recommendations(algorithm, score) - Get recommendations for algorithm
    • get_batch_recommendations(resultsList) - Recommendations for multiple files
  • Data: Migration strategies, alternatives, timelines

Web Application Structure

QuantumChecker.html
├── HTML Structure
│   ├── Header (title, subtitle)
│   ├── Upload Area (file selection)
│   └── Results Display
├── CSS Styling
│   ├── Dark theme
│   ├── Responsive design
│   └── Interactive animations
└── JavaScript Logic
    ├── Algorithm Database
    ├── Analysis Engine
    ├── Recommendation Engine
    └── UI Rendering

Web App Functions

  • analyzeFile(fileName) - File analysis
  • handleAnalyze() - Trigger analysis
  • getRiskClass(score) - Color coding
  • getRecommendations(algorithm) - Security advice
  • render() - UI update

Installation & Setup

Option 1: Python Desktop Application

Requirements:

  • Python 3.8 or higher
  • Windows, macOS, or Linux

Steps:

  1. Install Python

    # Windows: Download from https://python.org
# macOS: brew install python3
# Linux: sudo apt-get install python3

  2. Install Dependencies

    cd QuantumChecker
pip install -r requirements.txt

  3. Run the Application

    python main.py

requirements.txt:

pycryptodome==3.18.0
python-magic==0.4.27
tkinter  # Usually comes with Python

Option 2: Web Application

Requirements:

  • Any modern web browser
  • No installation needed!

Steps:

  1. Download QuantumChecker.html
  2. Double-click to open in browser
  3. Start analyzing files immediately!

Browser Compatibility:

  • Chrome 90+
  • Firefox 88+
  • Safari 14+
  • Edge 90+

How to Use

Python Application - Single File Analysis

  1. Run the program

    python main.py

  2. Click "📁 Select Single File"

  3. Browse and select an encrypted file

    • Examples: .gpg, .zip, .kyber, .key, .pem

  4. Click "🔍 Analyze File"

  5. View Results

    • Quantum Resistance Score (0-100)
    • Algorithm detected
    • Quantum safe status
    • Risk level assessment
    • Score breakdown by component

  6. View Recommendations (Optional)

    • Click "💡 Recommendations"
    • See migration strategy
    • Read why this matters
    • Get action steps

  7. Save Results (Optional)

    • Click "💾 Save Results"
    • Choose location
    • Results saved as .txt file

Python Application - Multiple File Analysis

  1. Click "📂 Select Multiple Files"

  2. Select 2 or more encrypted files

  3. Click "📊 Analyze Multiple"

  4. View Comparison

    • Total files analyzed
    • Average security score
    • Best and worst scores
    • Security ranking (sorted)

  5. View Portfolio Recommendations

    • Critical files count
    • Migration timeline
    • Recommended actions

Web Application

  1. Open QuantumChecker.html in browser

  2. Choose Analysis Mode

    • "Single File" - Analyze one file
    • "Multiple Files" - Compare security

  3. Upload Files

    • Click upload area
    • Select encrypted files
    • Files listed below

  4. Click "🔍 Analyze"

  5. View Results

    • Detailed security analysis
    • Risk badges with colors
    • Score breakdown with bars

  6. View Recommendations (for Single File)

    • Click "💡 View Recommendations"
    • Read why it matters
    • See action steps

Scoring Methodology

Algorithm Detection

The tool recognizes 20+ encryption file types:

{
    '.gpg': 'RSA/PGP',
    '.zip': 'AES',
    '.key': 'RSA/ECC',
    '.kyber': 'Kyber (Lattice)',
    '.pem': 'RSA/ECC',
    '.7z': 'AES-256',
    # ... and more
}

Score Calculation

Formula:

Total Score = Algorithm Score + Key Length Score + File Type Score + Entropy Score
            = (out of 30) + (out of 40) + (out of 20) + (out of 10)
            = 0-100

Example Calculations

Example 1: RSA-encrypted file (.gpg)

Algorithm Score:    8/30   (RSA is vulnerable)
Key Length Score:   10/40  (Likely 1024-bit or 2048-bit)
File Type Score:    10/20  (Legacy format)
Entropy Score:      5/10   (Standard encrypted data)
─────────────────────────
Total Score:        33/100 (CRITICAL RISK)

Example 2: AES-encrypted file (.zip)

Algorithm Score:    28/30  (AES is quantum-safe)
Key Length Score:   25/40  (AES-256, modern strength)
File Type Score:    18/20  (Modern format)
Entropy Score:      5/10   (Properly encrypted)
─────────────────────────
Total Score:        76/100 (MEDIUM RISK)

Example 3: Post-quantum file (.kyber)

Algorithm Score:    30/30  (Post-quantum, NIST-standard)
Key Length Score:   30/40  (Kyber uses lattice problems)
File Type Score:    18/20  (Modern format)
Entropy Score:      5/10   (Properly encrypted)
─────────────────────────
Total Score:        83/100 (LOW RISK)

Files Included

Python Application Files

File Purpose Language Lines
main.py GUI Application Python ~430
quantum_scorer.py Analysis Engine Python ~150
quantum_recommendations.py Recommendations Python ~280
requirements.txt Dependencies Text 3
README.md Documentation Markdown -

Web Application Files

File Purpose Language Size
QuantumChecker.html Complete web app HTML/CSS/JS ~20KB

Total Lines of Code:

  • Python: ~860 lines
  • Web: ~700 lines (HTML/CSS/JS)
  • Total: ~1,560 lines

Features

Core Features ✅

  • ✅ File Analysis

    • Detects encryption algorithm from file
    • Estimates key strength
    • Measures data entropy
    • Analyzes file metadata

  • ✅ Security Scoring

    • 0-100 scale
    • Weighted components
    • Color-coded risk levels
    • Visual progress bars

  • ✅ Single File Analysis

    • Detailed algorithm info
    • Quantum safe status
    • Component breakdown
    • Risk assessment

  • ✅ Multiple File Comparison

    • Analyze 2+ files simultaneously
    • Security ranking (sorted)
    • Average score calculation
    • Portfolio overview

  • ✅ Recommendations Engine

    • Algorithm-specific advice
    • Why threats matter
    • Action steps (5+ steps)
    • Migration timeline
    • Post-quantum alternatives

  • ✅ Dark/Light Mode

    • Toggle in web version
    • Eye-friendly interface
    • Responsive design

Python Desktop Features

  • ✅ Professional GUI with tkinter
  • ✅ Real-time file monitoring
  • ✅ Save results to .txt file
  • ✅ UTF-8 encoding support
  • ✅ Error handling & validation
  • ✅ Multiple file batch processing

Web Features

  • ✅ Single HTML file (no dependencies)
  • ✅ Works offline
  • ✅ Works in all modern browsers
  • ✅ Responsive mobile-friendly design
  • ✅ Smooth animations
  • ✅ No installation required

Future Enhancements

Short Term (v2.0)

  • Export to PDF reports
  • Create charts/graphs for scores
  • Support for more file types (50+)
  • Actual file encryption detection (not just extension)
  • Machine learning-based algorithm detection
  • Database of known encryption software

Medium Term (v3.0)

  • Real-time file monitoring
  • Integration with password managers
  • API for third-party tools
  • Command-line interface (CLI)
  • Mobile app (React Native)
  • Hardware security module (HSM) detection

Long Term (v4.0)

  • Quantum simulator to show Shor's algorithm
  • Virtual lab for encryption concepts
  • Integration with security scanning tools
  • Enterprise licensing
  • Compliance reporting (NIST, FIPS)
  • Multi-language support

Concepts Explained for Beginners

What is Quantum Computing?

Quantum computers use quantum bits (qubits) instead of regular bits. Unlike regular bits (0 or 1), qubits can be both 0 AND 1 simultaneously (superposition). This allows them to solve certain mathematical problems much faster.

What is Shor's Algorithm?

A quantum algorithm discovered by Peter Shor in 1994 that can:

  • Crack RSA encryption in polynomial time
  • Break ECC in polynomial time
  • Factor large numbers exponentially faster than classical computers

What is RSA?

RSA Encryption:

  • Based on factoring large numbers into prime factors
  • Very hard for classical computers (takes thousands of years)
  • Easy for quantum computers using Shor's algorithm (minutes)
  • Used for: Email, banking, HTTPS

What is AES?

AES Encryption:

  • Based on substitution and permutation operations
  • Hard for both classical AND quantum computers
  • Quantum computers only get a modest speedup
  • Used for: File encryption, disk encryption, messaging apps

What is Lattice-Based Cryptography?

Lattice Problems:

  • Based on shortest vector problem in lattices
  • Hard for both classical AND quantum computers
  • Even quantum computers can't solve efficiently
  • NIST has standardized lattice algorithms (Kyber, Dilithium)

Credits & References

Research Papers

  • Shor, P. W. (1997). "Polynomial-Time Algorithms for Prime Factorization and Discrete Logarithms on a Quantum Computer"
  • National Institute of Standards and Technology (2022). "Post-Quantum Cryptography Standardization"

Standards

  • NIST Post-Quantum Cryptography Project
  • FIPS 203 (Kyber)
  • FIPS 204 (Dilithium)
  • FIPS 205 (SPHINCS+)

Tools & Libraries

  • Python Cryptography Community (PyCryptodome)
  • tkinter Documentation
  • NIST Cybersecurity Resource Center

License

This project is provided for educational purposes. Feel free to modify and distribute.

Contact & Support

Project Status: ✅ Complete and Functional

Version: 1.0.0

Last Updated: October 2025

For Questions:

  • Review this README
  • Check the code comments
  • Test with the included example files
  • Refer to NIST resources for quantum cryptography

Summary

Quantum Resistance Checker is a comprehensive educational tool that:

  • ✅ Analyzes encrypted files
  • ✅ Scores quantum vulnerability (0-100)
  • ✅ Provides security recommendations
  • ✅ Educates about quantum threats
  • ✅ Offers migration guidance
  • ✅ Works offline (web version)
  • ✅ No installation needed (web version)
  • ✅ Professional and modern interface

Perfect for: Cybersecurity students, IT professionals, security researchers, and anyone concerned about post-quantum cryptography.

About

Analyze encrypted files for quantum vulnerability

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages