wifit3

# wifit3
> Un auditor Wi-Fi USB autonomo per Linux, Windows e macOS.

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/50012/04606166e4819097d373eac8e473da43c3c80449f1e3c4ed8b2652ada7a80d96.png" alt="wifit3 splash / adapter picker" width="700">
</p>

> È **richiesto** *almeno* uno degli [adattatori USB supportati](#supported-hardware).

## Perché?
* **Cross-Platform:** Funziona in modo identico su Linux, macOS e Windows.
* **Wireless Driver Heaven:** Lo stack wireless integrato evita l'inferno delle versioni dei driver del kernel e l'NDIS di Windows.
* **Zero Runtime Dependencies:** Nessun `aircrack-ng` o `reaver`, solo puro Python con le librerie PyUSB e Textual.

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/50012/2efdf06fe93e90c9b114d815ee6a0f847a42f4259fba335ee71e94a3c6c88fa6.gif" alt="wifit3 in action: WPS PushButton PSK capture" width="700">
</p>

---

## Funzionalità

### Ricognizione e analisi
- **Multi-Card Aggregation:** Cattura pacchetti su più adattatori contemporaneamente; scegli una scheda dedicata per l'iniezione.
- **Real-time Scanner:** Channel-hopping su 2.4GHz e 5GHz (suddiviso per multi-card); traccia l'intensità del segnale, le suite di crittografia, le modalità di transizione WPA3/SAE.
- **AP & Client Identification:** Identifica produttori e categorie dei dispositivi; estrae marca e modello del router dai beacon WPS.
- **VAP Decloaking:** Identifica le reti nascoste correlando i loro BSSID con i sibling visibili noti.
- **Packet Dashboard:** Visualizza in tempo reale le frequenze dei pacchetti beacon, data, injection e deauthentication.

### Attacchi e catture
- **WPA/WPA2 Handshakes:** Sniffing passivo e deauthentication mirata; convalida le coppie crackabili; esporta file `.pcap` e `.hc22000`.
- **PMKID Harvesting:** Raccolta tramite associazione attiva e sniffing passivo del materiale di chiave PMKID WPA/WPA2 (`.hc22000`).
- **EvilTwin WPA3 Downgrade:** Clona l'AP ed espelle i client (tramite CSA, BTM e de-auth) per catturare gli handshake. Funziona su schede singole e multiple.
- **WPS Recovery Suite:**
  - **PixieDust (2 modalità):** Recupero istantaneo offline del PIN sfruttando le debolezze del PRNG *Null Secret* e *Static Secret*.
  - **PushButton (PBC):** Rileva le pressioni fisiche del pulsante WPS ed estrae immediatamente la PSK WPA in chiaro.
  - **PIN Brute-Force:** Cracking del PIN WPS ripristinabile con database dei PIN noti e monitoraggio del blocco dell'AP.
- **WEP Suite:** ARP replay, ChopChop, Fake Authentication e recupero della chiave PTW in puro Python.

## Screenshot

| Scanner | Focus (singolo target) |
|---|---|
| ![Scanner](https://assets.kitploit.com/production/public/readmes/50012/24709c5d2e682635dbc1f238f6235658c265012351095aff0e197c74abb30b1b.png) | ![Focus](https://assets.kitploit.com/production/public/readmes/50012/cd1d31407229a1c28724255310dbc246dff51dc521e84fd2404c1594caaecc5d.png) |

## Hardware supportato

> **Importante:** *È richiesto almeno un adattatore wireless USB supportato.*

| Chipset | Bande | Schede (Marca + Modello) |
|---|---|---|
| Atheros AR9271 | 2.4 GHz | ALFA AWUS036**NHA**, TP-Link TL-WN722N V1 |
| MediaTek MT7601U | 2.4 GHz | Dongle "nano" generici senza marca |
| MediaTek MT7610U | 2.4 / 5 GHz | ALFA AWUS036**ACHM**, Panda PAU0B |
| MediaTek MT7612U | 2.4 / 5 GHz | ALFA AWUS036**ACM** |
| MediaTek MT7921AU | 2.4 / 5 GHz | ALFA AWUS036**AXM[L]**, Panda PAU0F |
| MediaTek MT7925U | 2.4 / 5 GHz | Netgear A9000 |
| Realtek RTL8812AU | 2.4 / 5 GHz | ALFA AWUS036**ACH** |
| Realtek RTL8814AU | 2.4 / 5 GHz | ALFA AWUS1900, ASUS USB-AC68 |
| Realtek RTL8821AU | 2.4 / 5 GHz | ALFA AWUS036**ACS**, TP-Link Archer T2U Plus/Nano |
| Realtek RTL8821CU | 2.4 / 5 GHz | Auscoumer 600 Mbps, Mercusys MU6H |
| Realtek RTL8922AU | 2.4 / 5 GHz | ASUS USB-BE93 |
| Realtek RTL8822BU | 2.4 / 5 GHz | TP-Link T3U Plus, Archer T4U v3 / T4U+ |
| Realtek RTL8822CU | 2.4 / 5 GHz | D-Link AC13U |
| Realtek RTL8187L | 2.4 GHz | ALFA AWUS036**H** |
| Realtek RTL8188EUS | 2.4 GHz | TP-Link TL-WN722N v2/v3, Mercusys MW150US |
| Realtek RTL8192FU | 2.4 GHz | D-Link AN3U rev. A1 |
| Ralink RT2570 | 2.4 GHz | Buffalo Nintendo Wi-Fi USB Controller |
| Ralink RT3070 | 2.4 GHz | ALFA AWUS036**NH**, TP-Link TL-WN7200ND |
| Ralink RT5370 | 2.4 GHz | LOTEKOO 150 Mbps |
| Ralink RT5372 | 2.4 GHz | Panda PAU05/PAU06 |
| Ralink RT5572 | 2.4 / 5 GHz | Panda PAU09 N600 |

Dettaglio delle capacità e dei limiti di ciascun dispositivo: [Supported Hardware Doc](https://github.com/derv82/wifit3/blob/master/docs/SUPPORTED-HARDWARE.md).

## Installazione ed esecuzione

### Opzione 1: Scaricare i binari precompilati (consigliato)
Scarica l'ultimo eseguibile standalone dalla pagina [**Releases**](https://github.com/derv82/wifit3/releases/latest):

* **Windows:** Scarica ed esegui `wifit3-windows-x64.exe`.
* **Linux (senza sudo):** `chmod +x wifit3-linux-x64 && ./wifit3-linux-x64`
* **macOS:** (aggira la quarantena)
  ```bash
  xattr -d com.apple.quarantine wifit3-macos-universal2
  chmod +x wifit3-macos-universal2
  ./wifit3-macos-universal2
  ```

### Opzione 2: Esecuzione dal codice sorgente
wifit3 utilizza [`uv`](https://docs.astral.sh/uv/) di Astral. `sync` configura le dipendenze:
```bash
uv sync
uv run wifit3
```

### Opzione 3: Compila il tuo binario
```bash
uv run pyinstaller wifit3.spec --noconfirm --clean
```
L'eseguibile binario viene scritto nella sottodirectory `dist/`.

## Configurazione una tantum del driver

wifit3 gestisce automaticamente la configurazione hardware all'interno dell'app, dopo aver cliccato il pulsante `START`:

- **Linux:** Richiede una volta tramite `pkexec`/`sudo` di scrivere i permessi udev e le blocklist in `/etc/modprobe.d/`.
- **macOS:** Nessuna installazione richiesta; collega il dispositivo e seleziona *Consenti* nella finestra di autorizzazione.
- **Windows:** Richiede una volta tramite UAC di installare WinUSB per il dispositivo.
- **VirtualBox:** Aggiungi il tuo/i tuoi dispositivo/i ai `USB Filters` di VirtualBox *prima* di collegarlo.

## Disinstallazione
Restituisci il dispositivo precedentemente installato allo stack Wi-Fi del tuo sistema operativo:

1. Seleziona la scheda nella schermata iniziale di wifit3.
2. Clicca il pulsante `Uninstall` e conferma.
3. Accetta la richiesta di elevazione (UAC su Windows o `pkexec` su Linux).
4. Scollega e ricollega l'adattatore.

Su Linux, questo elimina le regole `udev` e `modprobe` di wifit3.
Su Windows, questo disinstalla il binding WinUSB e attiva una nuova scansione dei dispositivi PnP (il vecchio driver si ricollega).

## *Grazie, Linux!*

wifit3 esiste solo grazie alle grandi persone che hanno fatto reverse-engineering e mantenuto questi driver wireless
per Linux. Di solito è un lavoro ingrato.

Ringraziamenti speciali a:
- **Christian "kimo" B. ([@kimocoder](https://github.com/kimocoder))** che mantiene **wifite2** e il driver DKMS RTL8188EUS di `aircrack-ng`.
- [**Neur0sp1cy**](https://github.com/neur0sp1cy): Caro amico e maestro del mio apprendistato su Linux e wireless-hacking.
- **Nick Morrow** ([@morrownr](https://github.com/morrownr)), leggenda, mantiene i driver DKMS out-of-tree
  per USB Realtek.

La lista completa è in **[CREDITS.md](https://github.com/derv82/wifit3/blob/master/docs/CREDITS.md)**.

## Come funziona: Mini-Driver

wifit3 aggira completamente lo stack Wi-Fi nativo del sistema operativo. Include port Python leggeri dei driver del kernel Linux ([src/wifit3/chips/\*](https://github.com/derv82/wifit3/tree/master/src/wifit3/chips)) che controllano direttamente i dispositivi wireless tramite trasferimenti bulk e control USB.

Poiché l'iniezione di frame a livello di registro e la modalità monitor vengono eseguite interamente in user space, le restrizioni NDIS di Windows e il locking dei driver del kernel Linux non si applicano.

Per dettagli sull'architettura, metodologia di porting dei driver e strumenti di replay delle tracce USB, consulta la [Documentazione di Porting](https://github.com/derv82/wifit3/blob/master/docs/porting/METHODOLOGY.md).

## Licenza e Disclaimer

**Codice:** Concesso in licenza sotto [**GNU General Public License v2.0**](https://github.com/derv82/wifit3/blob/master/LICENSE) (in linea con i driver Linux upstream).

**Firmware:** I blob firmware dei produttori caricati sugli adattatori vengono ridistribuiti verbatim sotto le rispettive licenze dei produttori (dettagli in [FIRMWARE.md](https://github.com/derv82/wifit3/blob/master/docs/FIRMWARE.md)).

**⚠️ Avviso e Disclaimer:** Da utilizzare solo su reti e apparecchiature di tua proprietà o che sei esplicitamente autorizzato a verificare. wifit3 opera direttamente sui registri hardware USB senza protezioni del kernel; usalo a tuo rischio.