AutoWIFI

Framework di penetration testing wireless.
Automatizza l'intera catena di attacco - dalla ricognizione allo sfruttamento - con un'interfaccia terminale pulita.

Caratteristiche

• Attacchi multi-vettore - WEP (ARP replay, fragmentation, chopchop), WPA/WPA2 (captura handshake, PMKID), WPS (pixie dust, attacco a forza bruta PIN)
• Selezione intelligente del target - Raccomanda automaticamente i vettori di attacco in base alla crittografia e alla configurazione del target
• Scansione in tempo reale - Rilevamento della rete in tempo reale con visualizzazione dell'intensità del segnale e tracciamento dei client
• Molteplici back-end per cracking - aircrack-ng, hashcat (GPU), John the Ripper
• Gestione delle sessioni - Salva, ripristina e riprende operazioni interrotte
• Generazione di report - Esporta i risultati in formato HTML, JSON e testo
• Gestione delle interfacce - Modalità monitor automatica, randomizzazione MAC, controllo del canale
• Verifica dell'handshake - Validazione multi-metodo degli handshake catturati
• Rilevamento delle wordlist - Rilevamento automatico delle wordlist installate (rockyou, seclists, ecc.)

Requisiti

• Linux con una scheda wireless che supporti la modalità monitor
• Python 3.9+
• Suite aircrack-ng (richiesto)
• Opzionale: hashcat, reaver, bully, hcxdumptool, mdk4, macchanger

Installazione

Da PyPI (consigliato)

pip install autowifi

Installa le dipendenze di sistema

Il framework utilizza la suite aircrack-ng e strumenti correlati. Installali per la tua distribuzione:

Debian / Ubuntu / Kali:

sudo apt update
sudo apt install -y aircrack-ng reaver bully hcxdumptool hcxtools hashcat macchanger mdk4 tshark

Arch Linux:

sudo pacman -S aircrack-ng reaver hashcat hcxdumptool hcxtools macchanger wireshark-cli

Fedora:

sudo dnf install aircrack-ng reaver hashcat hcxdumptool hcxtools macchanger wireshark-cli

Solo aircrack-ng è strettamente necessario. Gli altri sbloccano ulteriori vettori di attacco (WPS, PMKID, cracking GPU, ecc.).

Da sorgente

git clone https://github.com/momenbasel/AutoWIFI.git
cd AutoWIFI
pip install .

Sviluppo

git clone https://github.com/momenbasel/AutoWIFI.git
cd AutoWIFI
pip install -e .

Verifica installazione

sudo autowifi --version

Server MCP (Integrazione con agenti AI)

AutoWIFI include un server MCP (Model Context Protocol), che rende tutti gli strumenti di penetration testing wireless disponibili per assistenti di codifica AI come Claude Code, Codex, Gemini e Cursor.

Installa con supporto MCP

pip install autowifi[mcp]

Configura per Claude Code

Aggiungi a ~/.claude/settings.json:

{
  "mcpServers": {
    "autowifi": {
      "command": "autowifi-mcp"
    }
  }
}

Configura per Cursor

Aggiungi a .cursor/mcp.json:

{
  "mcpServers": {
    "autowifi": {
      "command": "autowifi-mcp"
    }
  }
}

Strumenti MCP disponibili

Ora il tuo agente AI può eseguire test di penetrazione wireless in modo autonomo.

Utilizzo

Modalità interattiva

sudo autowifi

Avvia la TUI completa con un flusso di lavoro basato su menu: scansione, selezione target, attacco, cracking.

Modalità CLI

Scansiona le reti:

sudo autowifi scan -i wlan0mon -d 30

Cattura handshake WPA:

sudo autowifi capture -i wlan0mon -b AA:BB:CC:DD:EE:FF -c 6 -t 120

Cracca un file di cattura:

sudo autowifi crack handshake.cap -w /usr/share/wordlists/rockyou.txt

Usa il back-end hashcat:

sudo autowifi crack handshake.cap -w rockyou.txt --backend hashcat

Vettori di attacco

Configurazione

Le impostazioni sono memorizzate in ~/.autowifi/config.json. Modificale attraverso il menu interattivo o direttamente:

{
  "interface": "wlan0",
  "scan_duration": 30,
  "deauth_count": 15,
  "handshake_timeout": 180,
  "default_wordlist": "/usr/share/wordlists/rockyou.txt",
  "crack_backend": "aircrack",
  "mac_randomize": false,
  "auto_crack": true
}

Struttura del progetto

autowifi/
  cli.py          - Punto di ingresso, modalità interattiva, comandi CLI
  ui.py           - Componenti dell'interfaccia utente del terminale (basati su Rich)
  scanner.py      - Rilevamento delle reti e tracciamento dei client
  attacks.py      - Implementazioni degli attacchi WEP, WPA, WPS, PMKID
  handshake.py    - Cattura e verifica dell'handshake
  cracker.py      - Cracking delle password multi-back-end
  interface.py    - Gestione delle interfacce wireless
  session.py      - Persistenza delle sessioni
  report.py       - Generazione di report in HTML/JSON/testo
  config.py       - Gestione della configurazione
  deps.py         - Controllo delle dipendenze

Aspetti legali

Questo strumento è destinato esclusivamente a test di sicurezza autorizzati e scopi educativi. L'accesso non autorizzato alle reti informatiche è illegale. Ottieni sempre la corretta autorizzazione scritta prima di eseguire test.

Licenza

GPL-3.0