toha3ee

Go로 작성된 로컬 및 네트워크 보안 평가 프레임워크입니다. 네트워크 평가 파이프라인 — 호스트 및 서비스 검색, 열거, 자격 증명 감사, 취약점 식별 및 승인된 익스플로잇 — 을 아우르는 연구 및 승인된 침투 테스트 도구입니다. 10개의 모듈 카테고리는 정찰, 열거, OSINT, MITM(ARP/DHCP/DNS/IPv6 포이즈닝 및 인라인 HTTP/HTTPS 가로채기), 무선, 스위치 계층, 웹, 인증, 스파이 활동 및 침투 후 단계에 걸쳐 있으며, 모두 대화형 세션, 안내 마법사 또는 일회성 명령 시퀀스로 구동됩니다.

MITM은 이 광범위한 영역 내의 하나의 기능일 뿐입니다. TOHA3EE는 중간자 시나리오에 국한되지 않습니다.

경고: toha3ee는 네트워크 트래픽을 적극적으로 리디렉션, 포이즈닝, 복호화 및 가로챕니다. 소유하고 있거나 명시적으로 테스트 권한을 받은 네트워크에서만 사용하십시오. 제3자를 대상으로 이러한 모듈을 실행하는 것은 대부분의 관할 지역에서 불법입니다. 먼저 docs/Security.md를 읽으십시오.

문서

• 사용자 — 시작하기 · 사용자 가이드 · 스크립팅 · 구성 · FAQ
• 참조 — 모듈 참조 (전체 70개 모듈) · 보고
• 개발자 — 아키텍처 · 기여 · 변경 로그
• 거버넌스 — 보안 · 행동 강령 · 라이선스

설치

원라이너 설치 프로그램은 최신 릴리스에서 플랫폼용으로 미리 빌드된 바이너리를 가져와 SHA-256 체크섬을 검증한 후 PATH에 추가합니다. 아직 미리 빌드된 바이너리가 없으면 대신 소스에서 빌드합니다.

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

또는 체크아웃에서:

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

설치 옵션 (Unix): --prefix <dir> (기본값: root인 경우 /usr/local/bin, 그렇지 않으면 ~/.local/bin), 셸 rc 편집을 건너뛰려면 --no-path, 다운로드 대신 빌드하려면 --from-source, 릴리스를 고정하려면 TOHA3EE_VERSION=<tag>. 시스템 전체에 설치하려면 sudo sh ...로 실행하십시오. Windows 설치 프로그램은 바이너리를 %LOCALAPPDATA%\Programs\toha3ee\bin에 넣고 사용자 PATH를 업데이트합니다. Windows-on-ARM64는 x64 빌드를 실행합니다.

Linux에서 설치 프로그램은 데스크톱 환경에도 앱을 등록합니다. 로고를 hicolor 아이콘 테마에 설치하고 설치 접두사 옆(예: /usr/local/share 또는 ~/.local/share)에 .desktop 항목을 배치하여 toha3ee가 GNOME 검색에 아이콘과 함께 나타나도록 합니다. Windows에서는 .ico를 복사하고 시작 메뉴 바로 가기를 만듭니다. 릴리스 tarball/zip에는 아이콘이 포함되어 있어 설치 프로그램이 동일한 검증된 아티팩트에서 등록할 수 있습니다.

제거: 바이너리와 설치 프로그램이 셸 rc에 추가한 PATH 줄을 삭제하십시오 (또는 Windows에서는 %LOCALAPPDATA%\Programs\toha3ee).

업데이트

설치 후 다음으로 업데이트하십시오:

toha3ee updates        # `toha3ee update` works as an alias

설치된 버전을 최신 공식 QYVORA GitHub 릴리스와 비교 확인하고, 다운로드의 SHA-256을 게시된 체크섬과 검증한 후 바이너리를 원자적으로 교체합니다. 다운그레이드는 거부되며 어떤 실패가 발생해도 현재 바이너리는 그대로 유지됩니다 — Go 툴체인이나 Git이 필요하지 않습니다. 자세한 내용은 docs/Update.md를 참조하십시오.

빌드

Go 1.26+ 및 libpcap이 필요합니다.

# Debian/Ubuntu
sudo apt install libpcap-dev

# then
go build ./cmd/toha3ee

Linux 빌드에는 libpcap 헤더가 필요합니다(설치 프로그램의 소스 빌드 폴백은 이를 확인하고 누락된 경우 올바른 apt/dnf 명령을 출력합니다). macOS는 Xcode Command Line Tools와 함께 libpcap을 제공합니다.

빠른 시작

# 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

대부분의 공격 모듈은 root 권한이 필요합니다(원시 소켓, 패킷 캡처 및 IP 포워딩). 가능하면 root로 또는 CAP_NET_ADMIN/CAP_NET_RAW 권한으로 실행하십시오. 색상 출력을 비활성화하려면 --no-color를, 상세 로깅을 위해서는 -v를 추가하십시오.

이 도구는 기본적으로 관리자 권한으로 실행됩니다. Linux/macOS에서는 sudo 아래에서 자신을 재실행하고 매 호출마다 관리자(root) 비밀번호를 묻습니다. 권한 없이 실행하려면 --no-sudo를 전달하거나 TOHA3EE_NO_SUDO=1을 설정하십시오. 예를 들어 빠른 toha3ee --no-sudo version과 같습니다.

아키텍처

모든 것은 모듈입니다. 모듈은 자신의 패키지 init()에서 스스로 등록되며 레지스트리에 의해 자동으로 노출됩니다. 공격을 추가한다는 것은 attacks.Module 계약을 구현하는 패키지를 internal/attacks/ 아래에 추가하는 것을 의미합니다(internal/attacks/attacks.go 참조):

• Meta() — ID, 카테고리, 위험도, 대상, 설명, 제한 사항
• Preflight(ctx) — 실행 전 사전 조건 확인
• Run(ctx, opts) — 공격 루프 (ctx.Done을 반드시 준수해야 함)
• Verify(ctx) — 발생한 일 보고
• Cleanup(ctx) — 모든 것을 되돌리고 네트워크 복원

중앙 safety 라이프사이클(internal/safety)은 등록된 정리 작업과 하트비트를 추적하여 패닉이나 SIGINT가 발생해도 모든 공격이 해제되도록 하며, 공유 store는 호스트 인벤토리, 캡처된 자격 증명, 세션 및 보고서 생성기에 공급되는 이벤트 로그를 유지합니다.

계층

경로	목적
cmd/toha3ee	CLI: 콘솔, 마법사, --eval, caplet 러너, script/build
internal/ui	콘솔 렌더링: 배너, 팔레트, 섹션, 테이블, 상태 글리프, HUD
internal/script	.toha3ee 스크립팅 언어: 렉서, 파서, 엔진
internal/attacks/	카테고리별 모든 공격 모듈
internal/netx/	프로토콜 기본 요소 (ARP, DHCP, DNS, NDP, 802.11, SMB/NTLM, 프록시, …)
internal/hijack	HTTP/HTTPS MITM 프록시 및 자격 증명/세션 가로채기
internal/phish	캡티브 포털 피싱 및 로그인 페이지 클론
internal/store	공유 데이터 저장소 및 이벤트 버스
internal/safety	정리/하트비트 라이프사이클
internal/config	JSON 구성 로딩
internal/oui	MAC 벤더 데이터베이스
pkg/certutil	프레임워크 CA 및 호스트별 TLS 인증서

모듈

전체 최신 카탈로그를 보려면 toha3ee modules를 실행하십시오. 주요 사항:

카테고리	모듈
mitm	arp.spoof, dns.spoof, dns.rebind, dhcp.rogue, dhcp.starve, dhcp6.spoof, icmp.redirect, ipv6.ra, ipv6.ndp, llmnr.poison, wpad.poison
espionage	http.harvest, http.proxy, https.proxy, ssl.strip, phish.inject
auth	default.creds, ntlm.relay, smb.signing, smb.kerberoast, auth.spray, auth.brute, auth.userenum, auth.asrep
recon	net.scan, net.ping, net.traceroute, net.osdetect, service.synscan, service.tcpconnect, service.udpscan, service.finxmas, service.ack, service.protoscan, service.idle, service.fingerprint, service.tls, web.dir, cve.suggest
osint	osint.dns, osint.whois, osint.ct, osint.asn, osint.shodan, osint.bucket, osint.wayback, osint.github, osint.hibp, osint.metadata, osint.dork, osint.harvest
enum	smtp.enum, snmp.enum, ldap.enum, nfs.enum, smb.enum, net.ip6sweep
web	web.misconfig
switch	switch.flood, switch.portsteal, switch.vlanhop, switch.cdp, switch.stp
wireless	wlan.scan, wlan.deauth, wlan.handshake, wlan.eviltwin, wlan.pmkid, wlan.beaconflood, wlan.karma
post	report.generate, session.replay, pcap.export

대화형 세션

toha3ee만 입력하거나(toha3ee tui, 또는 이전의 interactive/repl/shell 표기) 공유 QYVORA 터미널 애플리케이션을 엽니다. 명령은 프롬프트에서 입력되고 하나의 라이브 세션에 대해 평가되므로, net.scan 후 net.show는 동일한 호스트, 자격 증명 및 실행 중인 모듈을 봅니다. 평가는 명령마다 재구성되는 것이 아니라 누적됩니다.