qyvora/qyvora-toha3eeFramework d’exploitation réseau et MITM basé sur Go pour les tests d’intrusion autorisés, la reconnaissance réseau, l’interception de trafic, les tests de sécurité sans fil et la recherche sur les attaques des couches 2/3/7.
Un framework d'évaluation de la sécurité locale et réseau écrit en Go. C'est un outil de recherche et de tests d'intrusion autorisés qui couvre le pipeline d'évaluation réseau — découverte d'hôtes et de services, énumération, audit d'identifiants, identification de vulnérabilités et exploitation autorisée. Ses dix catégories de modules couvrent la reconnaissance, l'énumération, l'OSINT, le MITM (empoisonnement ARP/DHCP/DNS/IPv6 et interception HTTP/HTTPS en ligne), le sans-fil, la couche switch, le web, l'authentification, l'espionnage et la post-exploitation — le tout piloté depuis une session interactive, un assistant guidé, ou des séquences de commandes ponctuelles.
Le MITM est une capacité parmi d'autres dans ce domaine plus large : TOHA3EE ne se limite pas aux scénarios d'homme du milieu.
AVERTISSEMENT : toha3ee redirige, empoisonne, déchiffre et intercepte activement le trafic réseau. Utilisez-le uniquement sur des réseaux que vous possédez ou que vous êtes explicitement autorisé à tester. Exécuter ces modules contre des tiers est illégal dans la plupart des juridictions. Lisez d'abord
docs/Security.md.
Les installateurs en une ligne récupèrent le binaire précompilé pour votre plateforme depuis la dernière version, vérifient sa somme de contrôle SHA-256 et l'ajoutent à votre PATH. Si aucun binaire précompilé n'existe encore, ils compilent depuis les sources à la place.
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
Ou depuis un dépôt cloné :
make install # installs ~/.local/bin/toha3ee and adds it to PATH
Options d'installation (Unix) : --prefix <dir> (par défaut : /usr/local/bin en tant que root,
sinon ~/.local/bin), --no-path pour ne pas modifier votre shell rc, --from-source
pour compiler au lieu de télécharger, et TOHA3EE_VERSION=<tag> pour épingler une version.
Exécutez avec sudo sh ... pour installer à l'échelle du système. L'installateur Windows place le
binaire dans %LOCALAPPDATA%\Programs\toha3ee\bin et met à jour votre PATH utilisateur ;
Windows-on-ARM64 exécute la compilation x64.
Sous Linux, l'installateur enregistre également l'application auprès de l'environnement de bureau : il
installe le logo dans le thème d'icônes hicolor et dépose une entrée .desktop
à côté du préfixe d'installation (par ex. /usr/local/share ou ~/.local/share), afin que
toha3ee apparaisse dans la recherche de GNOME avec son icône. Sous Windows, il copie le
.ico et crée un raccourci dans le menu Démarrer. L'archive tar/zip de la version contient
l'icône afin que l'installateur puisse l'enregistrer depuis le même artefact vérifié.
Désinstallation : supprimez le binaire et la ligne PATH que l'installateur a ajoutée à votre
shell rc (ou %LOCALAPPDATA%\Programs\toha3ee sous Windows).
Une fois installé, mettez à jour avec :
toha3ee updates # `toha3ee update` works as an alias
Vérifie la version installée par rapport à la dernière version officielle GitHub de QYVORA, vérifie le SHA-256 du téléchargement par rapport à la somme de contrôle publiée, et remplace le binaire de manière atomique. Les rétrogradations sont refusées et tout échec laisse votre binaire actuel intact — aucune chaîne d'outils Go ni Git requise. Voir docs/Update.md pour plus de détails.
Nécessite Go 1.26+ et libpcap.
# Debian/Ubuntu
sudo apt install libpcap-dev
# then
go build ./cmd/toha3ee
Les compilations Linux nécessitent les en-têtes libpcap (le repli depuis les sources de l'installateur vérifie leur présence et affiche la bonne commande apt/dnf s'ils sont manquants). macOS fournit libpcap avec les 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 --no-sudo build scripts/full-pipeline.toha3ee
# Execute a .toha3ee script non-interactively
sudo ./toha3ee script --iface eth0 scripts/full-pipeline.toha3ee
La plupart des modules d'attaque nécessitent root (sockets bruts, capture de paquets et
transfert IP). Exécutez en tant que root ou avec CAP_NET_ADMIN/CAP_NET_RAW lorsque c'est possible.
Ajoutez --no-color pour désactiver la sortie colorée, -v pour la journalisation verbeuse.
L'outil s'exécute avec des privilèges administrateur par défaut : sous Linux/macOS, il
se ré-exécute sous sudo et demande le mot de passe administrateur (root) à
chaque invocation. Passez --no-sudo (ou définissez TOHA3EE_NO_SUDO=1) pour exécuter
sans privilèges, par ex. pour un rapide toha3ee --no-sudo version.
Tout est un module. Les modules s'auto-enregistrent dans leur init() de package et
sont exposés automatiquement par le registre ; ajouter une attaque signifie ajouter un
package sous internal/attacks/ qui implémente le contrat attacks.Module
(voir internal/attacks/attacks.go) :
Meta() — ID, catégorie, risque, cibles, description, limitationsPreflight(ctx) — vérifier les préconditions avant l'exécutionRun(ctx, opts) — la boucle d'attaque (doit respecter ctx.Done)Verify(ctx) — rapporter ce qui s'est passéCleanup(ctx) — tout annuler, restaurer le réseau