Single Click Customized Login Page
The Bluesocket vWLAN server comes with a default login screen, however there may be a desire to personalize or completely revamp this screen. This guide aims to provide the basic steps for customizing (or creating) a login single click sign on screen.
Throughout the guide references such as “Provision > Wireless > SSID” will be used. This refers to the various sections accessible through the banner at the top of the vWLAN Administrative User Interface (UI) as shown below.
Create a Local User
This user will be used for the single sign on page login. When a user “clicks” the “I Accept the Terms & Conditions button, they will essentially be logging in with this local user. This example illustrates creating a user with the name “guest” and password “guest”. To create the internal user, follow these steps:
1. From the Create Local User Menu (Provision > Auth > Local Users > Create > Local User) create a user with the Name: guest with a password of: guest and assign them to a pre-configured role for guest users.
2. Another very important setting is the number of active sessions the local user is allowed. A value of ‘0’ will allow unlimited sessions, however this setting can be modified if a total number of guest users is desired.
Upload Image File(s)
You can add your own text, images, or multimedia files to the HTML displayed on the login menu by uploading files as described in the File Uploads (Provision > Logins > File Uploads). These files will be used later in the Custom HTML portion of the guide.
Creating the Login Screen
Once the local user is configured and all necessary image files have been uploaded, one can proceed to create the Login Form. To specify the login settings, follow these steps:
1. From the Create Login Screen (Provision > Logins > Login Screens > Create > Login Screen ) menu, specify the Name for the Login Screen and be sure to, select Allow user logins option.
2. Next, specify the maximum number of login attempts allowed for users on this login form by entering the number in the appropriate field. Entering 0 indicates there is no maximum number. You will also be required to specify the delay (in minutes) before a user can attempt to login again after the maximum number of failed login attempts has been reached. Enter the value in the appropriate field.
3. Select “Enable Complete Customization of Login Screen”
After configuring the login attempt settings, you can configure the visual elements of the login form by select Next at the bottom of the screen.
Entering the HTML Text
Specify the customized HTML that will appear on the right of the login menu in the appropriate field. Please notice that the previously uploaded image files' stored path is listed on the right hand side of the page.
Enter the custom HTML above into the “Right side customization HTML” box (above).
The sample HTML code is provided (above); items in red will need to be modified. It is important to note the following lines.
- <input type="hidden" name="which_form" value="reg" /> <input type="hidden" name="bs_name" value="guest" /> <input type="hidden" name="bs_password" value="guest" />
- <img src="/local/adtran.jpg">
The bs_name and bs_password are passed to (https://<vWLAN IP ADDRESS>/login.pl) thus allowing the client to authenticate transparently. The bs_name and bs_password values are associated with the previously configured local user. The img src path and filename can be found above in the “Entering the HTML Text” Section.
*When the HTML has been modified, click the “Save” button.
Optional Checkbox Validation to Require Accepting Terms of Service (ToS)
Assign the Login Page to an SSID
The SSID that will be used must be configured to ensure users are redirected properly; either create a new SSID or edit an existing one by navigating to (Provision > Wireless > SSID). The "Default Role" must be set to “Un-registered” and the “Custom User Login” must be set to the previously configured Login Screen. Once the SSID has been created or edited, you will be required to Apply the changes to the APs.
To test the configuration, simply connect a client to the SSID, open a web browser, and try to access any web page. The client should be redirected to the terms of service page. If a certificate warning is present, either continue or add an exception, and from that time forward the client will only be prompted with the acknowledgment/disclaimer screen (for more information on eliminating certificate errors, please visit the ADTRAN Support Community) Shown below is the screen created in this example.