wifit3

# wifit3
> Um auditor de Wi-Fi USB autónomo para Linux, Windows e macOS.

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

> É **necessário** *pelo menos* um dos [adaptadores USB suportados](#hardware-suportado).

## Porquê?
* **Multiplataforma:** Funciona de forma idêntica em Linux, macOS e Windows.
* **Paraíso dos drivers wireless:** A stack wireless integrada evita o inferno das versões de drivers do kernel e o NDIS do Windows.
* **Zero dependências em runtime:** Sem `aircrack-ng` ou `reaver`, apenas Python puro com as bibliotecas PyUSB e Textual.

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/50012/2efdf06fe93e90c9b114d815ee6a0f847a42f4259fba335ee71e94a3c6c88fa6.gif" alt="wifit3 em ação: captura de PSK via WPS PushButton" width="700">
</p>

---

## Funcionalidades

### Reconhecimento e Análise
- **Agregação multi-placa:** Captura pacotes em vários adaptadores em simultâneo; escolhe uma placa dedicada para injetar.
- **Scanner em tempo real:** Channel-hopping em 2,4 GHz e 5 GHz (dividido para multi-placas); monitoriza a intensidade do sinal, suites de encriptação e modos de transição WPA3/SAE.
- **Identificação de AP e Cliente:** Identifica fabricantes e categorias de dispositivos; extrai a marca e o modelo do router a partir dos beacons WPS.
- **Desocultação de VAP:** Identifica redes ocultas correlacionando os seus BSSIDs com irmãos visíveis conhecidos.
- **Dashboard de Pacotes:** Visualiza em tempo real as taxas de pacotes beacon, de dados, de injeção e de desautenticação.

### Ataques e Capturas
- **Handshakes WPA/WPA2:** Sniffing passivo e desautenticação direcionada; valida pares crackáveis; exporta ficheiros `.pcap` e `.hc22000`.
- **Recolha de PMKID:** Recolha por associação ativa e sniffing passivo de material de chave PMKID WPA/WPA2 (`.hc22000`).
- **Downgrade WPA3 EvilTwin:** Clona o AP e expulsa os clientes (via CSA, BTM e desautenticações) para capturar handshakes. Funciona com uma ou várias placas.
- **Suite de Recuperação WPS:**
  - **PixieDust (2 modos):** Recuperação instantânea de PIN offline explorando as fraquezas de PRNG *Null Secret* e *Static Secret*.
  - **PushButton (PBC):** Deteta pressões físicas do botão WPS e extrai imediatamente a PSK WPA em texto simples.
  - **Força bruta de PIN:** Cracking de PIN WPS retomável com base de dados de PINs conhecidos e monitorização de bloqueio do AP.
- **Suite WEP:** ARP replay, ChopChop, Fake Authentication e recuperação de chave PTW em Python puro.

## Capturas de Ecrã

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

## Hardware Suportado

> **Importante:** *É necessário pelo menos um adaptador wireless USB suportado.*

| Chipset | Bandas | Placas (Marca + Modelo) |
|---|---|---|
| Atheros AR9271 | 2,4 GHz | ALFA AWUS036**NHA**, TP-Link TL-WN722N V1 |
| MediaTek MT7601U | 2,4 GHz | Dongles "nano" genéricos sem 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 |

Descrição detalhada das capacidades e limitações de cada dispositivo: [Documentação de Hardware Suportado](https://github.com/derv82/wifit3/blob/master/docs/SUPPORTED-HARDWARE.md).

## Instalação e Execução

### Opção 1: Baixar binários pré-compilados (recomendado)
Baixe o executável autônomo mais recente em [**Releases**](https://github.com/derv82/wifit3/releases/latest):

* **Windows:** Baixe e execute `wifit3-windows-x64.exe`.
* **Linux (sem sudo):** `chmod +x wifit3-linux-x64 && ./wifit3-linux-x64`
* **macOS:** (contornar a quarentena)
  ```bash
  xattr -d com.apple.quarantine wifit3-macos-universal2
  chmod +x wifit3-macos-universal2
  ./wifit3-macos-universal2
  ```

### Opção 2: Executar a partir do código-fonte
wifit3 usa o [`uv`](https://docs.astral.sh/uv/) da Astral. O `sync` configura as dependências:
```bash
uv sync
uv run wifit3
```

### Opção 3: Compilar seu próprio binário
```bash
uv run pyinstaller wifit3.spec --noconfirm --clean
```
O executável binário é gravado no subdiretório `dist/`.

## Configuração Única do Driver

O wifit3 lida automaticamente com a configuração de hardware dentro do aplicativo, após clicar no botão `START`:

- **Linux:** Solicita uma vez via `pkexec`/`sudo` para gravar permissões udev e blocklists em `/etc/modprobe.d/`.
- **macOS:** Nenhuma instalação necessária; conecte o dispositivo e selecione *Permitir* na caixa de diálogo de autorização.
- **Windows:** Solicita uma vez via UAC para instalar o WinUSB para o dispositivo.
- **VirtualBox:** Adicione seu(s) dispositivo(s) aos `USB Filters` do VirtualBox *antes* de conectar.

## Desinstalando
Devolva o dispositivo previamente instalado à pilha de Wi-Fi do seu sistema operacional:

1. Selecione a placa na tela inicial do wifit3.
2. Clique no botão `Uninstall` e confirme.
3. Aceite o prompt de elevação (UAC no Windows ou `pkexec` no Linux).
4. Desconecte e reconecte o adaptador.

No Linux, isso exclui as regras `udev` e `modprobe` do wifit3.
No Windows, isso desinstala a vinculação do WinUSB e dispara uma nova varredura de dispositivos PnP (o driver antigo se reconecta).

## *Obrigado, Linux!*

O wifit3 só existe por causa das grandes pessoas que fizeram engenharia reversa e mantiveram esses drivers
wireless do Linux. Geralmente é um trabalho ingrato.

Agradecimentos especiais a:
- **Christian "kimo" B. ([@kimocoder](https://github.com/kimocoder))** que mantém o **wifite2** e o driver DKMS RTL8188EUS do `aircrack-ng`.
- [**Neur0sp1cy**](https://github.com/neur0sp1cy): Amigo próximo e o mestre do meu aprendizado em Linux e hacking wireless.
- **Nick Morrow** ([@morrownr](https://github.com/morrownr)), lenda, mantém os drivers DKMS USB Realtek
  out-of-tree.

A lista completa está em **[CREDITS.md](https://github.com/derv82/wifit3/blob/master/docs/CREDITS.md)**.

## Como Funciona: Mini-Drivers

O wifit3 contorna inteiramente a pilha de Wi-Fi nativa do sistema operacional. Ele vem com ports leves em Python de drivers do kernel Linux ([src/wifit3/chips/\*](https://github.com/derv82/wifit3/tree/master/src/wifit3/chips)) que controlam diretamente dispositivos wireless via transferências USB bulk e control.

Como a injeção de frames em nível de registro e o modo monitor são realizados inteiramente no espaço do usuário, as restrições do NDIS do Windows e o bloqueio de drivers do kernel Linux não se aplicam.

Para detalhes de arquitetura, metodologia de portabilidade de drivers e ferramentas de replay de traces USB, consulte a [Documentação de Portabilidade](https://github.com/derv82/wifit3/blob/master/docs/porting/METHODOLOGY.md).

## Licença & Aviso Legal

**Código:** Licenciado sob [**GNU General Public License v2.0**](https://github.com/derv82/wifit3/blob/master/LICENSE) (compatível com os drivers Linux upstream).

**Firmware:** Blobs de firmware de fornecedores carregados nos adaptadores são redistribuídos literalmente sob as licenças de seus respectivos fabricantes (detalhes em [FIRMWARE.md](https://github.com/derv82/wifit3/blob/master/docs/FIRMWARE.md)).

**⚠️ Aviso & Isenção de Responsabilidade:** Para uso apenas em redes e equipamentos que você possui ou está explicitamente autorizado a auditar. O wifit3 opera diretamente nos registradores de hardware USB sem proteções do kernel; use por sua conta e risco.