Monitoring

Portal Sessions

Portal Sessions shows all currently active WiFi sessions in real time — every authenticated user who is online right now, with live bandwidth counters, session duration, and device details sourced from RADIUS accounting.

'alt' => 'Dashboard overview', 'caption' => 'The default Kiwire dashboard layout', 'screenshot' => true, 'class' => '', ]) Drop images into: public/assets/img/docs/{page}/{filename} --}}

Image not uploaded yet public/assets/img/docs/portal-sessions/overview.png

Portal Sessions — live list of authenticated users with bandwidth counters and disconnect actions.

What It Shows

The session list is populated from RADIUS accounting data. Each row represents one active authenticated session on your network. Sessions are updated as RADIUS Interim-Update accounting packets arrive from your access points.

Session Fields

Field	Description
`username`	The Kiwire user account that authenticated this session.
`ip_address`	IP address assigned to the device by the AP or DHCP server.
`mac_address`	The hardware MAC address of the connected device.
`nas_ip`	The IP address of the access point or NAS (Network Access Server) handling this session.
`zone`	Which zone this session belongs to, resolved from the NAS IP.
`session_start`	The timestamp when the session was first authenticated.
`session_duration`	Live counter showing how long the user has been connected (hh:mm:ss).
`data_in`	Total bytes downloaded by the device in this session, updated from RADIUS accounting.
`data_out`	Total bytes uploaded by the device in this session, updated from RADIUS accounting.

Actions

Disconnect Session

Click the Disconnect button on any row to forcibly terminate that user's session. Kiwire sends a RADIUS Change of Authorization (CoA) Disconnect-Request packet to the NAS IP. The AP removes the user from the network immediately and they are redirected back to the captive portal.

CoA disconnect requires your AP/NAS to support RFC 3576. Check your device documentation to confirm CoA is enabled and the shared secret matches.

View User

Click View User to jump directly to that user's detail page in the Users module, where you can see their full account details, usage history, and previous sessions.

Filters

Zone — show sessions for a specific zone only
AP / NAS — filter by access point IP
Username — locate a specific user's session
MAC Address — find sessions for a specific device

Refresh

The session list auto-refreshes every 30 seconds when Live Mode is enabled. You can also click the Refresh button at any time to fetch the latest data immediately. The last-updated timestamp is shown in the toolbar.

Session data comes from RADIUS accounting packets. If an access point is not sending Interim-Update packets (or is sending them infrequently), bandwidth counters may lag behind reality and sessions may appear active after a device disconnects. Configure your AP to send Interim-Updates every 60–300 seconds for accurate data.

Required Permissions

view-portal-session