get-the-hacker/docs/DETECTION.md
Aliaksandr Zasinets 791459edc8 gth
2026-10-27 14:16:13 +01:00

1.5 KiB

Detection Rules

GTH is a passive WIDS. It sends no attack frames.

Rule Default condition
Deauth / Disassoc 20 Deauth/Disassoc frames in 10 s. 5 sequences or 4 time bins.
Probe Recon 30 Probe Requests and 10 named SSIDs in 30 s. Recon only.
Evil Twin signs 3 beacons in 30 s. saved SSID, new BSSID, weaker security.
KARMA signs 5 matching SSIDs and 2 clients in 60 s. reply delay <= 2 s.
Auth rejects 8 authentication rejects in 60 s.
Assoc rejects 8 association rejects in 60 s.
EAPOL attempts 8 distinct M2 nonces in 60 s. no linked M2/M3/M4 exchange.
WPS rejects 8 WPS NACK errors in 60 s.
AP policy change 3 distinct beacon sequences in 30 s. saved AP name, security, or PMF policy differs. Policy observation only.

Edit config/default.json to set a trusted AP policy. The default trusted_aps list is empty. Use checked ssid, bssid, and security values. Security values are open, wep, wpa, wpa2, and wpa3. Use pmf_required only when the AP policy is known. Use ssid_hex for an exact SSID byte value when needed. Do not publish a private AP policy.

The Engine rejects bad fields, bad FCS, and old frame order. Retry copies do not count as new rule input. Complete verified Proof is needed for a positive attack indicator. A negative needs enough rule input, time, channel data, and capture quality. Recon and AP policy change stay observations. A failed Proof file check overrides a stored unsupported claim. No confidence percentage is claimed.