toha3ee

Un framework de evaluación de seguridad local y de red escrito en Go. Es una herramienta de investigación y pruebas de penetración autorizadas que cubre el pipeline de evaluación de red — descubrimiento de hosts y servicios, enumeración, auditoría de credenciales, identificación de vulnerabilidades y explotación autorizada. Sus diez categorías de módulos abarcan reconocimiento, enumeración, OSINT, MITM (envenenamiento ARP/DHCP/DNS/IPv6 e intercepción HTTP/HTTPS en línea), wireless, capa de switch, web, autenticación, espionaje y post-explotación — todo controlado desde una sesión interactiva, un asistente guiado o secuencias de comandos de una sola ejecución.

MITM es una capacidad dentro de este dominio más amplio: TOHA3EE no se limita a escenarios de man-in-the-middle.

ADVERTENCIA: toha3ee redirige, envenena, descifra e intercepta activamente el tráfico de red. Úsalo solo en redes que poseas o para las que tengas autorización explícita de prueba. Ejecutar estos módulos contra terceros es ilegal en la mayoría de jurisdicciones. Lee primero docs/Security.md.

Documentación

• Usuario — Primeros pasos · Guía de usuario · Scripting · Configuración · FAQ
• Referencia — Referencia de módulos (los 70 módulos) · Informes
• Desarrollador — Arquitectura · Contribuir · Changelog
• Gobernanza — Seguridad · Código de conducta · Licencia

Instalación

Los instaladores de una línea descargan el binario precompilado para tu plataforma desde la última versión, verifican su checksum SHA-256 y lo añaden a tu PATH. Si aún no existe un binario precompilado, lo compilan desde el código fuente.

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

O desde un checkout:

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

Opciones de instalación (Unix): --prefix <dir> (por defecto: /usr/local/bin como root, si no ~/.local/bin), --no-path para omitir la edición de tu shell rc, --from-source para compilar en lugar de descargar, y TOHA3EE_VERSION=<tag> para fijar una versión. Ejecuta con sudo sh ... para instalar a nivel de sistema. El instalador de Windows coloca el binario en %LOCALAPPDATA%\Programs\toha3ee\bin y actualiza el PATH de tu usuario; Windows-on-ARM64 ejecuta la compilación x64.

En Linux el instalador también registra la aplicación con el entorno de escritorio: instala el logo en el tema de iconos hicolor y coloca una entrada .desktop junto al prefijo de instalación (p. ej. /usr/local/share o ~/.local/share), de modo que toha3ee aparece en la búsqueda de GNOME con su icono. En Windows copia el .ico y crea un acceso directo en el Menú Inicio. El tarball/zip de la versión incluye el icono para que el instalador pueda registrarlo desde el mismo artefacto verificado.

Desinstalación: elimina el binario y la línea del PATH que el instalador añadió a tu shell rc (o %LOCALAPPDATA%\Programs\toha3ee en Windows).

Actualización

Una vez instalado, actualiza con:

toha3ee updates        # `toha3ee update` works as an alias

Comprueba la versión instalada contra la última versión oficial de QYVORA en GitHub, verifica el SHA-256 de la descarga contra el checksum publicado, y reemplaza el binario de forma atómica. Se rechazan las degradaciones y cualquier fallo deja tu binario actual intacto — no se requiere toolchain de Go ni Git. Consulta docs/Update.md para más detalles.

Compilación

Requiere Go 1.26+ y libpcap.

# Debian/Ubuntu
sudo apt install libpcap-dev

# then
go build ./cmd/toha3ee

Las compilaciones en Linux necesitan las cabeceras de libpcap (el fallback desde código fuente del instalador las comprueba e imprime el comando apt/dnf correcto si faltan). macOS incluye libpcap con Xcode Command Line Tools.

Inicio rápido

# 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 mayoría de los módulos de ataque requieren root (raw sockets, captura de paquetes y reenvío IP). Ejecuta como root o con CAP_NET_ADMIN/CAP_NET_RAW cuando sea posible. Añade --no-color para desactivar la salida con color, -v para logging detallado.

La herramienta se ejecuta con privilegios de administrador por defecto: en Linux/macOS se reejecuta a sí misma bajo sudo y solicita la contraseña de administrador (root) en cada invocación. Pasa --no-sudo (o establece TOHA3EE_NO_SUDO=1) para ejecutar sin privilegios, p. ej. para un rápido toha3ee --no-sudo version.

Arquitectura

Todo es un módulo. Los módulos se autorregistran en el init() de su paquete y son expuestos automáticamente por el registro; añadir un ataque significa añadir un paquete bajo internal/attacks/ que implemente el contrato attacks.Module (consulta internal/attacks/attacks.go):

• Meta() — ID, categoría, riesgo, objetivos, descripción, limitaciones
• Preflight(ctx) — comprobar las precondiciones antes de ejecutar
• Run(ctx, opts) — el bucle de ataque (debe respetar ctx.Done)
• Verify(ctx) — informar de lo que ocurrió
• Cleanup(ctx) — deshacer todo, restaurar la red

Un ciclo de vida central de safety (internal/safety) rastrea las limpiezas registradas y los heartbeats para que cada ataque se desmonte incluso ante un pánico o SIGINT, y un store compartido mantiene el inventario de hosts, las credenciales capturadas, las sesiones y el registro de eventos que alimenta al generador de informes.

Capas