⚡ VulnScan Pro

Uno scanner professionale di vulnerabilità informatiche realizzato con Python 3.13 e PyQt6. Progettato per valutazioni di sicurezza autorizzate, ricerca didattica e cybersecurity difensiva.

⚠ Avviso legale

Questo strumento deve essere utilizzato esclusivamente su sistemi di tua proprietà o per i quali hai ricevuto esplicita autorizzazione scritta a testarli. La scansione non autorizzata di sistemi che non possiedi è illegale nella maggior parte delle giurisdizioni. Gli autori non si assumono alcuna responsabilità per un uso improprio.

Caratteristiche

Screenshot

Installazione

Prerequisiti

• Python 3.10 o successivo (consigliata la 3.13)
• pip

Passaggi

# 1. Navigate to the project directory
cd "VulnScan_Pro"

# 2. (Recommended) Create a virtual environment
python -m venv venv
venv\Scripts\activate          # Windows
# source venv/bin/activate     # Linux / macOS

# 3. Install dependencies
pip install -r requirements.txt

# 4. Launch the application
python main.py

Utilizzo

Avvio di una scansione

1. Fare clic su Nuova scansione nella barra laterale
2. Inserisci il tuo target:
   • IP singolo: 192.168.1.1
   • Intervallo CIDR: 192.168.1.0/24
   • Intervallo IP: 192.168.1.1-254
   • Nome host: myserver.local
3. Seleziona un preset di porte (Porte comuni consigliato per scansioni rapide)
4. Regola numero di thread e timeout come necessario
5. Fare clic su ▶ Avvia scansione

Visualizzazione dei risultati

I risultati appaiono automaticamente nella pagina Risultati dopo ogni scansione.
Ogni risultato mostra:

• ID e nome CVE
• Gravità e punteggio CVSS
• Descrizione dettagliata
• Consigli di rimedio
• Versione del servizio rilevata

Generazione dei report

1. Vai a Report
2. Seleziona una scansione completata
3. Fare clic su Genera report PDF
4. Scegli una posizione di salvataggio

Filtraggio dei risultati

Utilizza la barra dei filtri in cima alla pagina Risultati per filtrare per:

• Livello di gravità
• IP dell'host
• Numero di porta
• Nome del servizio

Struttura del progetto

VulnScan_Pro/
├── main.py                  # Application entry point
├── requirements.txt
├── core/
│   ├── scanner.py           # Multithreaded port scanner (QThread)
│   ├── service_detector.py  # Banner grabbing & service fingerprinting
│   ├── vuln_engine.py       # CVE matching engine
│   ├── risk_calculator.py   # CVSS-weighted risk score
│   └── scheduler.py         # Recurring scan scheduler
├── gui/
│   ├── main_window.py       # Main window with sidebar navigation
│   ├── dashboard.py         # Statistics dashboard with charts
│   ├── scan_page.py         # Scan configuration & execution
│   ├── results_page.py      # Findings browser with filtering
│   ├── history_page.py      # Historical scan management
│   ├── reports_page.py      # PDF report generation
│   ├── settings_page.py     # Application preferences
│   └── widgets/
│       ├── stat_card.py     # Metric summary card
│       ├── charts.py        # DonutChart, BarChart, LineChart
│       └── severity_badge.py# Severity pill badge
├── database/
│   ├── db_manager.py        # SQLite CRUD operations
│   └── vuln_db.py           # Local vulnerability database (40+ CVEs)
├── reports/
│   └── pdf_generator.py     # ReportLab PDF report builder
└── utils/
    ├── validators.py         # Input validation
    ├── network_utils.py      # Socket utilities
    └── logger.py             # Centralised logging

Database delle vulnerabilità

Il database CVE locale copre i servizi comuni, tra cui:

Uso etico

Questo strumento è stato realizzato per:

• ✅ Testare i tuoi sistemi
• ✅ Impegni di penetration testing autorizzati
• ✅ Laboratori didattici di cybersecurity
• ✅ Valutazione della sicurezza difensiva
• ❌ Scansione di sistemi senza autorizzazione
• ❌ Ricognizione dannosa
• ❌ Qualsiasi attività illegale

Note sull'architettura

• Threading: Tutto l'I/O di rete viene eseguito in worker QThread utilizzando ThreadPoolExecutor per il probing parallelo delle porte. La GUI non si blocca mai.
• Database: SQLite con modalità WAL e applicazione delle foreign key tramite db_manager.py.
• Grafici: Widget personalizzati basati su QPainter — nessuna libreria di grafici esterna richiesta.
• Report: framework ReportLab Platypus con stile dark theme personalizzato.