Repository navigation
Discovery and Evidence
alwkala edited this page Oct 6, 2026
·
1 revision
NETWATCH uses an unprivileged, multi-layer sensor architecture to gather authentic network intelligence without requiring Administrator or root privileges.
On Windows, NETWATCH avoids raw sockets and third-party capture drivers (Npcap/WinPcap) by querying native user-mode APIs:
-
GetIpNetTable: Reads the OS kernel ARP cache populated by normal network activity. -
IcmpSendEcho: Unprivileged ICMP ping to actively solicit ARP cache entries from quiet hosts across RFC 1918 subnets. -
SendARP: Single-IP hardware address resolution for fallback verification.
NETWATCH correlates observable evidence across multiple local protocols:
- Queries UDP port 137 on active hosts.
- Extracts Windows workstation/server names and the 6-byte Unit ID (hardware MAC address).
- Detects multi-homed machines and validates MAC addresses against the ARP table.
- Listens to multicast M-SEARCH on
239.255.255.250:1900. -
Zero-Fetch Invariant: Records the
Locationheader string as authentic diagnostic evidence only. The engine never dials or fetches HTTP XML from devices, preventing SSRF and network tampering.
- Listens on
224.0.0.251:5353. - Extracts advertised
.localservices (_printer._tcp,_airplay._tcp,_googlecast._tcp,_workstation._tcp). - Hardened against DNS compression pointer loops and oversized malformed packets.
All discovery probes pass through IsAllowedDiscoveryDestination:
- Strictly restricts probe destinations to RFC 1918 private IPv4 subnets and link-local multicast.
- Blocks public Internet egress at the socket layer.
- Prohibits probe loops against loopback interfaces.
NETWATCH — Local Network Intelligence & Asset Ledger • Engineered by Alwkala