The Error511/Client Status Page¶
From version 8.0.0 onwards, openNDS has a Client Status Page.
This page is accessible by any connected client by accessing the default url:
If the client has been authenticated in the normal way by the client CPD process, a page is served displaying the Gatewayname and the Network Zone the client device is currently using.
A list of allowed quotas and current usage is displayed along with “Refresh” and “Logout” buttons.
If the client has not been authenticated, or has been deauthenticated due to timeout or quota usage, then a “Error 511 Network Authentication Required” page is displayed with “Refresh” and “Portal Login” buttons.
The “Portal Login” button allows the client to immediately attempt to login without waiting for the client CPD to trigger.
The URL used to access this page can be changed by setting the config option gatewayfqdn.
For best results it is recommended that gatewayfqdn is set to two words separated by a single period eg in OpenWrt:
option gatewayfqdn 'my.status'Warning - if set, services on port 80 of the gateway will no longer be accessible (eg Luci AdminUI)
By default, the Error511/Status page will be found at
http://status.client/by a redirection of port 80 tohttp://gatewayaddress:gatewayport/*Disable GatewayFQDN* by setting the option to ‘disable’ ie:
option gatewayfqdn 'disable'
An alternate Useful Example:
option gatewayfqdn 'login.page'
Custom Status Page¶
The default client status page is generated dynamically by the script /usr/lib/opennds/client_params.sh
An alternate Status page script can be used by setting the configuration option “statuspath” in the config file. Ensure the alternate script file is flagged as executable.