Login

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.

Note: The Web API in the Public Spot provides you with a convenient tool for creating new Public Spot users on the LANCOM's internal RADIUS server. Further information about this is available in the Reference Manual under the section "Public Spot".

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>