⚡ VulnScan Pro

Un escáner profesional de vulnerabilidades de ciberseguridad construido con Python 3.13 y PyQt6. Diseñado para evaluaciones de seguridad autorizadas, investigación educativa y ciberseguridad defensiva.

⚠ Aviso Legal

Esta herramienta solo debe utilizarse en sistemas de su propiedad o para los que tenga permiso explícito por escrito para realizar pruebas. El escaneo no autorizado de sistemas que no le pertenecen es ilegal en la mayoría de las jurisdicciones. Los autores no aceptan responsabilidad alguna por el uso indebido.

Características

Captura de pantalla

Instalación

Requisitos previos

• Python 3.10 o posterior (se recomienda 3.13)
• pip

Pasos

# 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

Uso

Iniciar un escaneo

1. Haga clic en Nuevo escaneo en la barra lateral
2. Ingrese su objetivo:
   • IP única: 192.168.1.1
   • Rango CIDR: 192.168.1.0/24
   • Rango IP: 192.168.1.1-254
   • Nombre de host: myserver.local
3. Seleccione un conjunto de puertos predefinido (se recomienda Common Ports para escaneos rápidos)
4. Ajuste el número de hilos y el tiempo de espera según sea necesario
5. Haga clic en ▶ Iniciar escaneo

Visualización de resultados

Los resultados aparecen automáticamente en la página Resultados después de cada escaneo.
Cada hallazgo muestra:

• ID y nombre del CVE
• Gravedad y puntuación CVSS
• Descripción detallada
• Consejos de remediación
• Versión del servicio detectado

Generar informes

1. Navegue a Informes
2. Seleccione un escaneo completado
3. Haga clic en Generar informe PDF
4. Elija una ubicación de guardado

Filtrar resultados

Utilice la barra de filtros en la parte superior de la página de Resultados para filtrar por:

• Nivel de gravedad
• IP del host
• Número de puerto
• Nombre del servicio

Estructura del proyecto

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

Base de datos de vulnerabilidades

La base de datos local de CVE cubre servicios comunes como:

Uso ético

Esta herramienta está diseñada para:

• ✅ Pruebas en sus propios sistemas
• ✅ Compromisos de pruebas de penetración autorizadas
• ✅ Laboratorios educativos de ciberseguridad
• ✅ Evaluación de seguridad defensiva
• ❌ Escanear sistemas sin permiso
• ❌ Reconocimiento malicioso
• ❌ Cualquier actividad ilegal

Notas de arquitectura

• Hilos: Todo el E/S de red se ejecuta en trabajadores QThread usando ThreadPoolExecutor para el sondeo paralelo de puertos. La GUI nunca se bloquea.
• Base de datos: SQLite con modo WAL y aplicación de claves foráneas mediante db_manager.py.
• Gráficos: Widgets personalizados basados en QPainter — no requiere biblioteca de gráficos externa.
• Informes: Framework ReportLab Platypus con estilo de tema oscuro personalizado.