If the external gateway sends a "Login" request in an XML file, the Public Spot activates online access for the corresponding user. A "Login" request contains the attribute COMMAND="RADIUS_LOGIN".
If the Public Spot does not use a RADIUS server, a "login" request prompts it to store the user and the associated MAC address directly in the internal Status table. As a result, the user is immediately authenticated in future, and there is no need to display a login page for entering the username and password.
When you operate a RADIUS server, a 'login' request can only be successfully processed if the login data of the corresponding user already exists on the RADIUS server.
The XML interface can process the following XML elements for a request:
- SUB_USER_NAME
- User name
- SUB_PASSWORD
- User password
- SUB_MAC_ADDR
- MAC address of the user's device Possible formats include:
- 00164115208c
- 00:16:41:15:20:8c
- 00-16-41-15-20-8c
The XML interface then sends the gateway a "Login" response, which can contain the following XML elements:
- SUB_USER_NAME
- User name
- SUB_STATUS
- The current user status. The following values are possible:
- RADIUS_LOGIN_ACCEPT: Login successful
- RADIUS_LOGIN_REJECT: Login rejected
- SUB_MAC_ADDR
- MAC address of the user's device Possible formats include:
- 00164115208c
- 00:16:41:15:20:8c
- 00-16-41-15-20-8c
Some examples of XML files are given below:
- Login request
-
The external gateway sends the data for the start of a session to the Public Spot:
<?xml version="1.0" encoding="ISO-8859-1"?> <PUBLICSPOTXMLINTERFACE> <ACCESS_CUBE COMMAND="RADIUS_LOGIN"> <SUB_USER_NAME>user2350</SUB_USER_NAME> <SUB_PASSWORD>5juchb</SUB_PASSWORD> <SUB_MAC_ADDR>00164115208c</SUB_MAC_ADDR> </ACCESS_CUBE> </PUBLICSPOTXMLINTERFACE>
The Public Spot enables 'user2350' in the internal Status table.
- Login response:
-
The XML interface sends a confirmation about the start of a session to the external gateway:
<?xml version="1.0" encoding="ISO-8859-1" ?> <PUBLICSPOTXMLINTERFACE> <ACCESS_CUBE ID="WLC-4006_PM" IP="192.168.100.2" COMMAND="USER_STATUS"> <SUB_STATUS>RADIUS_LOGIN_ACCEPT</SUB_STATUS> <SUB_MAC_ADDR>00:16:41:15:20:8b</SUB_MAC_ADDR> <SUB_USER_NAME>user2350</SUB_USER_NAME> <TXRATELIMIT>0</TXRATELIMIT> <RXRATELIMIT>0</RXRATELIMIT> <SECONDSEXPIRE>0</SECONDSEXPIRE> <TRAFFICEXPIRE>0</TRAFFICEXPIRE> <ACCOUNTCYCLE>0</ACCOUNTCYCLE> <IDLETIMEOUT>0</IDLETIMEOUT> </ACCESS_CUBE> </PUBLICSPOTXMLINTERFACE>