toha3ee

Um framework de avaliação de segurança local e de rede escrito em Go. É uma ferramenta de pesquisa e de testes de penetração autorizados que cobre o pipeline de avaliação de rede — descoberta de hosts e serviços, enumeração, auditoria de credenciais, identificação de vulnerabilidades e exploração autorizada. As suas dez categorias de módulos abrangem recon, enumeração, OSINT, MITM (envenenamento ARP/DHCP/DNS/IPv6 e interceção inline de HTTP/HTTPS), wireless, camada de switch, web, auth, espionagem e pós-exploração — tudo controlado a partir de uma sessão interativa, de um assistente guiado ou de sequências de comandos únicos.

O MITM é uma capacidade dentro deste domínio mais amplo: o TOHA3EE não se limita a cenários de man-in-the-middle.

AVISO: o toha3ee redireciona, envenena, desencripta e interceta ativamente o tráfego de rede. Utilize-o apenas em redes que possui ou para as quais tem autorização explícita de teste. Executar estes módulos contra terceiros é ilegal na maioria das jurisdições. Leia primeiro docs/Security.md.

Documentação

• Utilizador — Primeiros passos · Guia do utilizador · Scripting · Configuração · FAQ
• Referência — Referência de módulos (todos os 70 módulos) · Relatórios
• Programador — Arquitetura · Contribuir · Changelog
• Governança — Segurança · Código de Conduta · Licença

Instalação

Os instaladores de uma linha obtêm o binário pré-compilado para a sua plataforma a partir da versão mais recente, verificam o respetivo checksum SHA-256 e adicionam-no ao seu PATH. Se ainda não existir um binário pré-compilado, compilam a partir do código-fonte.

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 a partir de um checkout:

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

Opções de instalação (Unix): --prefix <dir> (predefinição: /usr/local/bin como root, caso contrário ~/.local/bin), --no-path para não editar o seu shell rc, --from-source para compilar em vez de descarregar, e TOHA3EE_VERSION=<tag> para fixar uma versão. Execute com sudo sh ... para instalar a nível de sistema. O instalador do Windows coloca o binário em %LOCALAPPDATA%\Programs\toha3ee\bin e atualiza o PATH do utilizador; Windows-on-ARM64 executa a compilação x64.

No Linux, o instalador também regista a aplicação no ambiente de desktop: instala o logótipo no tema de ícones hicolor e coloca uma entrada .desktop junto ao prefixo de instalação (por exemplo /usr/local/share ou ~/.local/share), para que o toha3ee apareça na pesquisa do GNOME com o seu ícone. No Windows, copia o .ico e cria um atalho no Menu Iniciar. O tarball/zip da versão inclui o ícone para que o instalador o possa registar a partir do mesmo artefacto verificado.

Desinstalação: elimine o binário e a linha do PATH que o instalador adicionou ao seu shell rc (ou %LOCALAPPDATA%\Programs\toha3ee no Windows).

Atualização

Depois de instalado, atualize com:

toha3ee updates        # `toha3ee update` works as an alias

Verifica a versão instalada em relação à versão oficial mais recente do QYVORA no GitHub, valida o SHA-256 da transferência em relação ao checksum publicado e substitui o binário de forma atómica. As reversões de versão são recusadas e qualquer falha deixa o binário atual intacto — não é necessária toolchain Go nem Git. Consulte docs/Update.md para mais detalhes.

Compilação

Requer Go 1.26+ e libpcap.

# Debian/Ubuntu
sudo apt install libpcap-dev

# then
go build ./cmd/toha3ee

As compilações para Linux precisam dos cabeçalhos libpcap (o fallback de compilação a partir do código-fonte do instalador verifica a sua presença e imprime o comando apt/dnf correto se estiverem em falta). O macOS inclui a libpcap com as Xcode Command Line Tools.

Início 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

A maioria dos módulos de ataque requer root (raw sockets, captura de pacotes e encaminhamento IP). Execute como root ou com CAP_NET_ADMIN/CAP_NET_RAW sempre que possível. Adicione --no-color para desativar a saída colorida, -v para registo verboso.

A ferramenta é executada com privilégios de administrador por predefinição: no Linux/macOS reexecuta-se sob sudo e pede a palavra-passe de administrador (root) em cada invocação. Passe --no-sudo (ou defina TOHA3EE_NO_SUDO=1) para executar sem privilégios, por exemplo para um rápido toha3ee --no-sudo version.

Arquitetura

Tudo é um módulo. Os módulos auto-registam-se no init() do seu pacote e são expostos automaticamente pelo registo; adicionar um ataque significa adicionar um pacote sob internal/attacks/ que implemente o contrato attacks.Module (ver internal/attacks/attacks.go):

• Meta() — ID, categoria, risco, alvos, descrição, limitações
• Preflight(ctx) — verificar pré-condições antes de executar
• Run(ctx, opts) — o ciclo de ataque (deve respeitar ctx.Done)
• Verify(ctx) — reportar o que aconteceu
• Cleanup(ctx) — desfazer tudo, restaurar a rede

Um ciclo de vida central de safety (internal/safety) acompanha as limpezas registadas e os heartbeats para que cada ataque seja desmontado mesmo em caso de panic ou SIGINT, e um store partilhado mantém o inventário de hosts, as credenciais capturadas, as sessões e o registo de eventos que alimenta o gerador de relatórios.

Camadas