toha3ee

Un framework di valutazione della sicurezza locale e di rete scritto in Go. È uno strumento di ricerca e di penetration testing autorizzato che copre la pipeline di valutazione della rete — scoperta di host e servizi, enumerazione, verifica delle credenziali, identificazione delle vulnerabilità e sfruttamento autorizzato. Le sue dieci categorie di moduli spaziano da recon, enumerazione, OSINT, MITM (avvelenamento ARP/DHCP/DNS/IPv6 e intercettazione inline HTTP/HTTPS), wireless, switch-layer, web, auth, spionaggio e post-exploitation — il tutto gestito da una sessione interattiva, da un wizard guidato o da sequenze di comandi one-shot.

Il MITM è una capacità all'interno di questo dominio più ampio: TOHA3EE non è limitato agli scenari man-in-the-middle.

AVVISO: toha3ee reindirizza, avvelena, decifra e intercetta attivamente il traffico di rete. Usalo solo su reti di tua proprietà o che sei esplicitamente autorizzato a testare. Eseguire questi moduli contro terze parti è illegale nella maggior parte delle giurisdizioni. Leggi prima docs/Security.md.

Documentazione

• Utente — Per iniziare · Guida utente · Scripting · Configurazione · FAQ
• Riferimento — Riferimento moduli (tutti i 70 moduli) · Reporting
• Sviluppatore — Architettura · Contribuire · Changelog
• Governance — Sicurezza · Codice di condotta · Licenza

Installazione

Gli installer one-liner scaricano il binario precompilato per la tua piattaforma dall'ultima release, ne verificano il checksum SHA-256 e lo aggiungono al tuo PATH. Se non esiste ancora un binario precompilato, eseguono la build dai sorgenti.

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/qyvora/qyvora-toha3ee/main/scripts/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/qyvora/qyvora-toha3ee/main/scripts/install.ps1 | iex

Oppure da un checkout:

make install   # installs ~/.local/bin/toha3ee and adds it to PATH

Opzioni di installazione (Unix): --prefix <dir> (predefinito: /usr/local/bin come root, altrimenti ~/.local/bin), --no-path per saltare la modifica del tuo shell rc, --from-source per compilare invece di scaricare, e TOHA3EE_VERSION=<tag> per fissare una release. Esegui con sudo sh ... per installare a livello di sistema. L'installer Windows mette il binario in %LOCALAPPDATA%\Programs\toha3ee\bin e aggiorna il PATH utente; Windows-on-ARM64 esegue la build x64.

Su Linux l'installer registra anche l'app con l'ambiente desktop: installa il logo nel tema di icone hicolor e inserisce una voce .desktop accanto al prefisso di installazione (ad es. /usr/local/share o ~/.local/share), così toha3ee compare nella ricerca di GNOME con la sua icona. Su Windows copia il .ico e crea una scorciatoia nel Menu Start. Il tarball/zip della release contiene l'icona, così l'installer può registrarla dallo stesso artefatto verificato.

Disinstallazione: elimina il binario e la riga del PATH che l'installer ha aggiunto al tuo shell rc (o %LOCALAPPDATA%\Programs\toha3ee su Windows).

Aggiornamento

Una volta installato, aggiorna con:

toha3ee updates        # `toha3ee update` works as an alias

Verifica la versione installata rispetto all'ultima release ufficiale QYVORA su GitHub, controlla lo SHA-256 del download rispetto al checksum pubblicato, e sostituisce il binario in modo atomico. I downgrade vengono rifiutati e qualsiasi errore lascia intatto il binario corrente — non sono richiesti toolchain Go o Git. Vedi docs/Update.md per i dettagli.

Build

Richiede Go 1.26+ e libpcap.

# Debian/Ubuntu
sudo apt install libpcap-dev

# then
go build ./cmd/toha3ee

Le build Linux richiedono gli header libpcap (il fallback from-source dell'installer li controlla e stampa il comando apt/dnf corretto se mancano). macOS include libpcap con gli Xcode Command Line Tools.

Avvio rapido

# Interactive session (bare command drops straight in)
sudo ./toha3ee --iface eth0

# Interactive session (explicit subcommand)
sudo ./toha3ee tui --iface eth0

# Guided wizard
sudo ./toha3ee wizard --iface eth0

# One-shot: scan the subnet, then show what was found
sudo ./toha3ee --eval "net.scan; net.show" --iface eth0

# One-shot: procedural deep recon (synscan -> fingerprint -> service enum)
sudo ./toha3ee --eval "net.recon; net.profile" --iface eth0

# Non-interactive caplet script
sudo ./toha3ee run --iface eth0 caplets/basic.cap

# Dry-run a .toha3ee script (validates it, prints the plan, sends no packets)
./toha3ee --no-sudo build scripts/full-pipeline.toha3ee

# Execute a .toha3ee script non-interactively
sudo ./toha3ee script --iface eth0 scripts/full-pipeline.toha3ee

La maggior parte dei moduli di attacco richiede root (socket raw, cattura pacchetti e IP forwarding). Esegui come root o con CAP_NET_ADMIN/CAP_NET_RAW dove possibile. Aggiungi --no-color per disabilitare l'output colorato, -v per il logging verboso.

Lo strumento viene eseguito con privilegi di amministratore per impostazione predefinita: su Linux/macOS si ri-esegue sotto sudo e richiede la password di amministratore (root) a ogni invocazione. Passa --no-sudo (o imposta TOHA3EE_NO_SUDO=1) per eseguire senza privilegi, ad es. per un rapido toha3ee --no-sudo version.

Architettura

Tutto è un modulo. I moduli si auto-registrano nel loro package init() e vengono esposti automaticamente dal registry; aggiungere un attacco significa aggiungere un package sotto internal/attacks/ che implementa il contratto attacks.Module (vedi internal/attacks/attacks.go):

• Meta() — ID, categoria, rischio, target, descrizione, limitazioni
• Preflight(ctx) — verifica le precondizioni prima dell'esecuzione
• Run(ctx, opts) — il ciclo di attacco (deve rispettare ctx.Done)
• Verify(ctx) — riporta cosa è successo
• Cleanup(ctx) — annulla tutto, ripristina la rete

Un ciclo di vita centrale safety (internal/safety) traccia i cleanup registrati e gli heartbeat, così ogni attacco viene smontato anche in caso di panic o SIGINT, e uno store condiviso mantiene l'inventario degli host, le credenziali catturate, le sessioni e il registro eventi che alimenta il generatore di report.

Livelli