Network Scanner (FastAPI + React)

• Backend FastAPI con un endpoint WebSocket que transmite los resultados a medida que se obtienen — sin polling ni recarga de página.
• Escáner de puertos concurrente mediante ThreadPoolExecutor: recorre todos los puertos principales de una subred en paralelo, y luego agrega los resultados por host.
• Tabla de detección de servicios que cubre 100+ puertos conocidos (HTTP, SSH, RDP, MSSQL, Redis, MongoDB, Docker, K8s API…).
• Clasificación de riesgo (alto / medio / bajo) por puerto abierto basada en un RISK_MAP curado (Telnet, RDP, listener de Metasploit, bases de datos expuestas…).
• API REST con CORS habilitado en paralelo al endpoint WebSocket para facilitar la integración.
• Frontend React/Vite con tarjetas de host actualizadas en tiempo real, badges de puertos coloreados por riesgo e indicador de progreso del escaneo.

Transporte

WebSocket (FastAPI + uvicorn) — streaming en tiempo real

Concurrencia

ThreadPoolExecutor — sondeo paralelo de puertos por host

Cobertura de puertos

100+ servicios conocidos en el dict KNOWN_SERVICES

Niveles de riesgo

alto / medio / bajo por puerto (Telnet, RDP, BD expuestas…)

Stack

Python 3, FastAPI, uvicorn, websockets · React 18, Vite

1. 1
   Descubrimiento de hosts

   El backend resuelve la subred local y hace ping a cada IP para construir la lista de hosts activos.
2. 2
   Escaneo de puertos concurrente

   Para cada host activo, un ThreadPoolExecutor sondea la lista TOP_PORTS en paralelo, recopilando los puertos abiertos y los nombres de servicios.
3. 3
   Clasificación de riesgos

   Cada puerto abierto se busca en RISK_MAP y se etiqueta como alto / medio / bajo según el riesgo de exposición conocido.
4. 4
   Streaming WebSocket

   Los resultados se envían al frontend en tiempo real en cuanto cada host termina su escaneo — sin esperar a que finalice el escaneo completo.
5. 5

# Backend
pip install fastapi uvicorn websockets
python backend.py

# Frontend (terminal separada)
cd scanner-ui
npm install && npm run dev