GET THE HACKER

걷고. 스캔하고. 탐지하고. 이해하라.

GTH는 Aliaksandr Zasinets가 만든 수동형 Wi-Fi WIDS입니다. 수신한 프레임에서 공격 징후를 검사합니다. 증거를 저장합니다. 라이선스: GPL-2.0-only.

무엇을 탐지하나요?

GTH는 Deauth 폭주, AP 정책 변경, Evil Twin 징후를 검사합니다. 또한 Recon, KARMA 징후, EAPOL 시도, 반복된 거부도 검사합니다. 정상적인 Probe Request와 알 수 없는 AP는 공격이 아닙니다. MAC 주소는 사람을 식별하지 않습니다.

flowchart TD
 A[Wi-Fi Frames] --> B[Capture and Decode]
 B --> C[WIDS Rules]
 C --> D[Saved Evidence]
 D --> E[Shared Assessment]
 E --> F[Console and Dashboard]
 E --> G[HTML PDF JSON]

설치

Python 3.11+, SQLite 지원, Bash가 필요합니다. Linux 또는 Termux에서는 iw와 ip도 필요합니다. Scapy 2.6.1이 포함되어 있습니다. 기본 사용에는 pip install이 필요하지 않습니다. 원시 캡처에는 root 권한, 지원되는 드라이버, Monitor Mode가 필요합니다.

복사한 후 스크립트 모드를 설정하세요:

chmod +x gth.sh install.sh

bash install.sh를 한 번 실행하여 gth.sh 명령을 추가하세요. 사용자의 bin 폴더를 사용합니다. 어떤 패키지도 설치하지 않습니다.

실행

./gth.sh

플래그는 필요하지 않습니다. Ctrl+C는 캡처를 중지하고 보고서를 저장합니다. 연결이 끊긴 wlan2는 드라이버가 지원하면 Monitor Mode로 진입할 수 있습니다. 변경된 무선 상태는 종료 시 복원됩니다. 연결된 어댑터는 자동으로 전환되지 않습니다. Managed 모드의 wlan0은 로컬 링크 상태를 제공합니다. 패킷 WIDS는 제공하지 않습니다. GTH는 현재 채널을 검사합니다. 채널을 호핑하지 않습니다. GPS는 선택 사항입니다. 캡처는 GPS 신호 없이도 작동합니다.

결과 읽기

결과	의미
DETECTED	저장된 증거가 공격 지표 규칙과 일치함
NOT DETECTED	검사된 규칙과 프레임에서 어떤 징후도 일치하지 않음
NOT ASSESSED	검사에 완전한 결과가 없음

네트워크, 검사, 이벤트, 도움말에는 1~4를 사용하세요. 세부 정보에는 화살표, Enter, Esc를 사용하세요. 도움말에 표시된 로컬 Dashboard URL을 여세요. AP 다이어그램은 개략도입니다. 위치 지도가 아닙니다.

Linux는 새 세션을 이 앱의 reports/에 저장합니다. Android는 결과를 /sdcard/Download/GTH/에 저장합니다. 보고서와 로그는 런타임에 생성됩니다. 소스 파일이 아닙니다.

오프라인 명령

./gth.sh demo
./gth.sh replay /path/to/capture.pcap
./gth.sh report /path/to/session
python3 tools/verify_proofs.py /path/to/session

Demo는 메모리에서 합성 프레임을 생성합니다. 무선 프레임을 전송하지 않습니다. Replay에는 원시 Wi-Fi PCAP, PCAPNG 또는 정규화된 JSONL 입력이 필요합니다. 검증을 위해 세션 로그와 Proof 파일을 함께 보관하세요.

설치, Android, 아키텍처, 탐지, 보고서, 한계를 읽어 보세요. 포함된 소스 라이선스는 타사 코드를 참조하세요.