Framework basato su Go per l'exploitation di rete e attacchi MITM, progettato per penetration testing autorizzati, ricognizione di rete, intercettazione del traffico, test di sicurezza wireless e ricerca su attacchi Layer 2/3/7.
Un framework per la 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, livello switch, web, auth, spionaggio e post-sfruttamento — tutte gestite da una sessione interattiva, da una procedura guidata o da sequenze di comandi one-shot.
MITM è una capacità all'interno di questo dominio più ampio: TOHA3EE non è limitato agli scenari man-in-the-middle.
ATTENZIONE: toha3ee reindirizza, avvelena, decifra e intercetta attivamente il traffico di rete. Usalo solo su reti di tua proprietà o per cui sei esplicitamente autorizzato a eseguire test. Eseguire questi moduli contro terze parti è illegale nella maggior parte delle giurisdizioni. Leggi prima
docs/Security.md.
Gli installer one-liner scaricano il binario precompilato per la tua piattaforma dalla release più recente, ne verificano il checksum SHA-256 e lo aggiungono al tuo PATH. Se non esiste ancora un binario precompilato, eseguono invece la compilazione 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 file rc della shell, --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 di Windows colloca il
binario in %LOCALAPPDATA%\Programs\toha3ee\bin e aggiorna il PATH dell'utente;
Windows-on-ARM64 esegue la build x64.
Su Linux l'installer registra anche l'applicazione 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
file .ico e crea un collegamento 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
file rc della shell (oppure %LOCALAPPDATA%\Programs\toha3ee su Windows).
Una volta installato, aggiorna con:
toha3ee updates # `toha3ee update` works as an alias
Confronta la versione installata con l'ultima release ufficiale di QYVORA su GitHub, verifica 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 né il toolchain Go né Git. Vedi docs/Update.md per i dettagli.
Richiede Go 1.26+ e libpcap.
# Debian/Ubuntu
sudo apt install libpcap-dev
# then
go build ./cmd/toha3ee
Le build Linux richiedono gli header di libpcap (il fallback dalla compilazione dai sorgenti dell'installer li verifica e stampa il comando apt/dnf corretto se mancano). macOS include libpcap con gli Xcode Command Line Tools.
# 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 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 (raw socket, cattura pacchetti e IP
forwarding). Eseguire come root o con CAP_NET_ADMIN/CAP_NET_RAW ove possibile.
Aggiungere --no-color per disabilitare l'output colorato, -v per il logging dettagliato.
I verbi che interagiscono con lo stack di rete (tui, wizard, eval, run,
script) vengono eseguiti con privilegi amministrativi per impostazione predefinita: su Linux/macOS lo strumento
si riesegue sotto sudo e richiede la password amministrativa (root).
I verbi solo locali non escalano mai e non richiedono password — version, modules,
capabilities, completion, help, updates, build e report vengono eseguiti
senza privilegi come utente invocante. Passare --no-sudo (o impostare
TOHA3EE_NO_SUDO=1) per sopprimere l'escalation anche per i verbi di rete.
Tutto è un modulo. I moduli si auto-registrano nel proprio package init() e
sono esposti automaticamente dal registry; aggiungere un attacco significa aggiungere un
package sotto internal/attacks/ che implementa il contratto attacks.Module
(vedere internal/attacks/attacks.go):
Meta() — ID, categoria, rischio, target, descrizione, limitazioniPreflight(ctx) — verifica le precondizioni prima dell'esecuzioneRun(ctx, opts) — il ciclo di attacco (deve rispettare ctx.Done)Verify(ctx) — riporta cosa è accadutoCleanup(ctx) — annulla tutto, ripristina la rete