Framework de exploração de rede e MITM baseado em Go para testes de penetração autorizados, reconhecimento de rede, interceptação de tráfego, testes de segurança sem fio e pesquisa de ataques nas camadas 2/3/7.
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, autenticação, espionagem e pós-exploração — tudo operado a partir de uma sessão interativa, de um assistente guiado ou de sequências de comandos one-shot.
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 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.
Os instaladores one-liner descarregam 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> (padrão: /usr/local/bin como root,
caso contrário ~/.local/bin), --no-path para não editar o rc do seu shell, --from-source
para compilar em vez de baixar, e TOHA3EE_VERSION=<tag> para fixar uma versão.
Execute com sudo sh ... para instalar em todo o sistema. O instalador do Windows coloca o
binário em %LOCALAPPDATA%\Programs\toha3ee\bin e atualiza o PATH do usuário;
Windows-on-ARM64 executa a build x64.
No Linux, o instalador também registra o aplicativo no ambiente de desktop: ele
instala o logo no tema de ícones hicolor e adiciona uma entrada .desktop
junto ao prefixo de instalação (por exemplo, /usr/local/share ou ~/.local/share), para que
toha3ee apareça na busca do GNOME com seu ícone. No Windows, ele copia o
.ico e cria um atalho no Menu Iniciar. O tarball/zip da versão carrega o
ícone para que o instalador possa registrá-lo a partir do mesmo artefato verificado.
Desinstalação: exclua o binário e a linha do PATH que o instalador adicionou ao seu
rc do shell (ou %LOCALAPPDATA%\Programs\toha3ee no Windows).
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, verifica o SHA-256 da transferência em relação à soma de verificação publicada, e substitui o binário de forma atómica. As reversões são recusadas e qualquer falha deixa o seu binário atual intacto — não é necessária a toolchain Go nem o Git. Consulte docs/Update.md para mais detalhes.
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 do libpcap (o fallback de compilação a partir do código-fonte do instalador verifica sua presença e imprime o comando apt/dnf correto caso estejam ausentes). O macOS já inclui o libpcap com as 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
A maioria dos módulos de ataque requer root (raw sockets, captura de pacotes e encaminhamento de IP). Execute como root ou com CAP_NET_ADMIN/CAP_NET_RAW quando possível. Adicione --no-color para desativar a saída colorida, -v para registro detalhado.
Os verbos que acessam a pilha de rede (tui, wizard, eval, run, script) são executados com privilégios administrativos por padrão: no Linux/macOS a ferramenta se reexecuta sob sudo e solicita a senha do administrador (root). Os verbos apenas locais nunca escalam privilégios e não exigem senha — version, modules, capabilities, completion, help, updates, build e report são executados sem privilégios como o usuário que os invoca. Passe --no-sudo (ou defina TOHA3EE_NO_SUDO=1) para suprimir a escalada também para os verbos de rede.
Tudo é um módulo. Os módulos se autorregistram no init() do seu pacote e são expostos automaticamente pelo registro; adicionar um ataque significa adicionar um pacote em internal/attacks/ que implemente o contrato attacks.Module (veja internal/attacks/attacks.go):
Meta() — ID, categoria, risco, alvos, descrição, limitaçõesPreflight(ctx) — verifica as pré-condições antes de executarRun(ctx, opts) — o laço de ataque (deve respeitar ctx.Done)Verify(ctx) — relata o que aconteceuCleanup(ctx) — desfaz tudo, restaura a redeDescubra as ferramentas mais usadas pela nossa comunidade.
Sem dados de popularidade ainda.