doc/developer/ClientProtocol

Version 2 (modified by datamile, 13 years ago)

--

Client Protocol

This page describles the messaging between the wifidog client and auth server once a user has been validated and permitted access to the internet. It is client level messaging and not node level as described in the Server Heartbeat.

Periodically the wifidog client will start a thread to report the status of each user connection. Currently this is used to reporting incoming/outgoing counters for each user, and to show that the user is still connected.

The following message is sent for each connected user

auth_server:/auth/index.php?
stage=counters
ip=
mac=
token=
incoming=
outgoing=

In response the auth server with response with a valid status, and a new user message, or an auth server error.

The new user status can be

AUTH_DENIED - User firewall users are deleted and the user removed.
AUTH_VALIDATION_FAILED - User email validation timeout has occured and user/firewall is deleted
AUTH_ALLOWED - User was valid, add firewall rules if not present
AUTH_VALIDATION - Permit user access to email to get validation email under default rules

auth server errors do not currently change firewall or user status.

Custom versions of the auth server set auth_DENIED when they wish to timeout a user, or close a node etc, to force the user to be terminated.