Scanner Réseau (FastAPI + React)

• Backend FastAPI avec un endpoint WebSocket qui diffuse les résultats au fur et à mesure — sans polling ni rechargement de page.
• Scanner de ports concurrent via ThreadPoolExecutor : parcourt tous les top ports d'un sous-réseau en parallèle, puis agrège les résultats par hôte.
• Table de détection de services couvrant 100+ ports connus (HTTP, SSH, RDP, MSSQL, Redis, MongoDB, Docker, K8s API…).
• Classification des risques (élevé / moyen / faible) par port ouvert basée sur un RISK_MAP (Telnet, RDP, listener Metasploit, bases de données exposées…).
• API REST avec CORS activé en parallèle du endpoint WebSocket pour faciliter l'intégration.
• Frontend React/Vite avec cartes d'hôtes en mise à jour temps réel, badges de ports colorés par risque et indicateur de progression du scan.

Transport

WebSocket (FastAPI + uvicorn) — streaming temps réel

Concurrence

ThreadPoolExecutor — sondage parallèle des ports par hôte

Couverture ports

100+ services connus dans le dict KNOWN_SERVICES

Niveaux de risque

élevé / moyen / faible par port (Telnet, RDP, BDD exposées…)

Stack

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

1. 1
   Découverte des hôtes

   Le backend résout le sous-réseau local et pinge chaque IP pour construire la liste des hôtes actifs.
2. 2
   Scan de ports concurrent

   Pour chaque hôte actif, un ThreadPoolExecutor sonde la liste TOP_PORTS en parallèle, collectant les ports ouverts et les noms de services.
3. 3
   Classification des risques

   Chaque port ouvert est recherché dans RISK_MAP et étiqueté élevé / moyen / faible selon le risque d'exposition connu.
4. 4
   Streaming WebSocket

   Les résultats sont envoyés au frontend en temps réel dès que chaque hôte termine son scan — sans attendre la fin du scan complet.
5. 5

# Backend
pip install fastapi uvicorn websockets
python backend.py

# Frontend (terminal séparé)
cd scanner-ui
npm install && npm run dev