Skip to content

Portal Events

Every event includes type plus event-specific fields.

Event type Fields Notes
portal_client_seen ip, mac, user_agent, request_type, timestamp Emitted for portal requests. mac is best-effort from the SoftAP station table and is "unknown" when unavailable.
portal_viewed client_ip Portal root page viewed
portal_dns_hijack client_ip, destination, count, free_heap, heap_min_free, heap_max_alloc Rate-limited diagnostic emitted when firmware answers a plaintext custom-resolver DNS query with the portal AP address. destination is the resolver IP the client attempted to use; heap fields report current free heap, minimum free heap, and largest allocatable block.
captive_data ip, user_agent, request_type, timestamp, data Submitted credential/form data from POST /login, GET /login, or credential-like GET query fields on / and /continue
client_associated client, bssid, rssi Association monitor event when that optional monitor is active

Core transport and framing: PROTOCOL-SPEC.md