Uno strumento semplificato per un Wi-Fi assessment veloce e un punto di partenza per chi inizia.

Questo è il primo articolo del sito, e ho scelto di dedicarlo ad un mio progetto: WiFiCatcher, un tool open source per la ricognizione Wi-Fi, per la quale ha contribuito anche @tvasari. L’idea di partenza è semplice ed è quella di unificare le funzionalità degli strumenti più noti e renderle fruibili da un’unica interfaccia. Questa necessità è nata direttamente sul campo durante i Wi-Fi Assessment a cui ho preso parte, rivelandosi al contempo un ottimo punto di partenza per chi si sta avvicinando al wireless penetration testing.

L’Idea di Base

Chiunque abbia provato a fare recon su una rete wireless conosce airodump-ng: uno strumento eccezionale, ma il cui output è un muro di testo che scorre nel terminale. Access point, client, BSSID, canali, potenza, cifratura, handshake, tutto mescolato in tabelle che si aggiornano di continuo. Se per un professionista questo è pane quotidiano, per un principiante rappresenta spesso un ostacolo scoraggiante.

La vera criticità non risiede nella mancanza di informazioni ma nella loro forma. Le relazioni tra access point e dispositivi connessi costituiscono a tutti gli effetti un grafo strutturato, eppure vengono mostrate come semplici righe di testo. WiFiCatcher nasce proprio da una riflessione fatta durante i nostri assessment. Ci siamo posti una domanda ben precisa. E se potessimo letteralmente vedere la rete invece di limitarci a leggerne i dati?

Cos’è WiFiCatcher

Dal punto di vista funzionale, il progetto si fonda sugli strumenti già consolidati nel settore del pentesting, come airodump-ng, aireplay-ng, tshark e EAP_buster. La vera novità è la veste grafica in cui sono integrati, progettata per rendere immediatamente comprensibile tutto ciò che accade nell’etere.

Ogni access point e ogni client diventa un nodo, ogni associazione client-AP diventa un arco. Il risultato è una fotografia dell’ambiente che si costruisce sotto i tuoi occhi, con dettaglio per ogni nodo come potenza del segnale, canale, cifratura, cipher, autenticazione, ecc…

Architettura

L’applicazione è suddivisa in due componenti ben distinti, l’app principale WiFiCatcher e un piccolo servizio separato chiamato warden. Grazie a questa struttura WiFiCatcher gira sempre con i permessi dell’utente che lo lancia, mentre al warden vengono delegate le poche operazioni che richiedono un accesso di root. Lo installi una volta sola come demone systemd attivato via socket e da quel momento ci pensa il sistema operativo ad avviarlo su richiesta solo quando serve davvero accedere all’hardware di rete. Si tratta di un approccio molto più pulito che fa sì che l’applicazione principale non debba mai girare come root.

Dal punto di vista tecnologico il codice è scritto in Python e si appoggia a un numero ridotto di dipendenze molto solide:

• Backend: si basa su FastAPI servito da uvicorn in ascolto esclusivamente in locale. Espone le API che il frontend interroga e coordina le chiamate agli strumenti di sistema.

• Frontend: sfrutta una pagina nel browser per disegnare il grafo interattivo appoggiandosi a Cytoscape.js con layout fCoSE. L’intero sistema gira sulla tua macchina senza richiedere account o servizi in cloud.

• Strumenti esterni: sfrutta la suite aircrack-ng, tshark, wpa_supplicant e altri programmi noti. WiFiCatcher semplicemente non li reimplementa e non distribuisce i binari. L’approccio è quello di appoggiarsi ai pacchetti già presenti nel sistema e richiamarli all’occorrenza.

Il punto di forza del progetto sta proprio nell’unificazione. Il sistema non mira a ricreare le funzionalità dei singoli tool, ma a centralizzarle orchestrando il loro lavoro e restituendo una visione d’insieme su un’unica piattaforma.

Cosa puoi fare

WiFiCatcher offre tre funzionalità principali, tutte selezionabili direttamente dall’interfaccia iniziale. Di seguito analizziamo ogni modalità nel dettaglio.

Cattura live

In questa modalità basta selezionare la scheda di rete per vedere il grafo prendere vita in tempo reale man mano che vengono scoperti access point e dispositivi connessi. Cliccando su ogni nodo è possibile esaminarne a fondo le caratteristiche e visualizzare dettagli tecnici chiave come ESSID, BSSID, canale, cipher, tipo di encryption ed altro. Il tool non si limita a mostrare i dati ma fornisce suggerimenti pratici e delinea i possibili percorsi di attacco in base alla specifica tecnologia rilevata sul target. Dal punto di vista offensivo si ha il pieno controllo per inviare pacchetti di deautenticazione mirati verso client o AP e catturare il conseguente handshake WPA direttamente in tempo reale. Il sistema gestisce in modo trasparente anche le reti WPA-Enterprise mostrando a schermo i certificati del server RADIUS e gli username intercettati durante l’autenticazione.

Quando la scansione si affolla e il grafo diventa difficile da seguire, gli stessi dati si possono leggere anche in forma tabellare con access point e client su righe distinte.

Replay

Questa funzione permette di caricare un file CSV salvato da airodump-ng per esplorare una scansione passata in totale assenza di rete. È possibile ripercorrere l’acquisizione nodo per nodo simulando una scoperta in tempo reale oppure visualizzare immediatamente il quadro completo. L’interfaccia mantiene il medesimo grafo, la stessa tabella e tutti i dettagli di una sessione live. In questo modo si ha tutto il tempo di rivedere la ricognizione e pianificare le strategie di attacco.

WPA Enterprise Enum

L’applicazione mette a disposizione tre strumenti fondamentali per l’analisi su reti WPA enterprise. I primi due operano in maniera passiva e richiedono l’intercettazione di uno scambio EAP iniziale tra client e access point. Avendo a disposizione questa cattura il tool permette di esportare il certificato del server RADIUS e di estrarre in chiaro i nomi utente intercettati.

Il terzo strumento agisce invece in modo attivo. Fornendo le credenziali di un account di dominio valido il sistema esegue l’enumerazione dei metodi EAP supportati dalla rete e ti permette di seguire in diretta l’avanzamento dei vari tentativi.

Installazione

git clone https://github.com/0xPR3ST1JH0NN7/WiFiCatcher
cd WiFiCatcher

# strumenti di sistema
sudo apt install aircrack-ng tshark wpasupplicant

# dipendenze Python
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

# installa il warden
sudo ./packaging/install-warden.sh

Avvio

# Dopo aver attivato il virtual env
python -m WiFiCatcher

Stato del progetto

WiFiCatcher ha raggiunto la versione 1.0.0 e lo sviluppo continua attivamente. La roadmap delle prossime release espanderà il tool con nuove funzionalità

• Integrazione di ulteriori tecniche e vettori di attacco Wi-Fi

• Sviluppo di un sistema di suggerimenti mirato per gli attacchi più comuni contro le reti WPA3

Note Legali e Disclaimer

L’intercettazione del traffico Wi-Fi, l’invio di frame di deautenticazione e i tentativi di accesso tramite 802.1X su reti di terzi, in assenza di un’esplicita autorizzazione, costituiscono un illecito. WiFiCatcher è uno strumento sviluppato esclusivamente per finalità didattiche, per l’impiego in laboratori personali e per attività di penetration testing regolarmente autorizzate. L’utente è il solo responsabile delle proprie azioni e gli autori declinano ogni responsabilità per eventuali usi impropri o illegali del software.

Licenza

WiFiCatcher è distribuito con licenza MIT, che si applica esclusivamente al codice sorgente del progetto. Gli strumenti esterni e gli eventuali componenti di terze parti inclusi nel repository mantengono le rispettive licenze originali. Maggiori dettagli sono disponibili nel file THIRD_PARTY_NOTICES.md.

Autori

WiFiCatcher è sviluppato da @0xPR3ST1JH0NN7 e @tvasari.