Adtran Bluesocket Configuration Guide

You can confirm your environment under Operator Customizations.

Checklist before proceeding with the Adtran Bluesocket configuration

  1. The following information is required when adding Adtran Bluesocket gateways to a hotspot.
    1. AP MAC
    2. vWLAN Network Interface public address
    3. vWLAN Domain ID
      Example of where to obtain the Domain ID-
  2. The MAC of all APs that will be broadcasting the Guest WiFi signal need to be properly added to the hotspot as gateways or guests could receive a hotspot deactivated message.

The following instructions outline how to setup a Adtran Bluesocket network for the Marketing4WiFi Platform.  This guide covers details such as configuring RADIUS, walled garden entries, and captive portals.  This guide assumes that your Bluesocket controller is already operational and on a live network with adopted Access Points. Please make sure any firewall rules, web content filters, and other security measures have been configured to interface with the platform.


Log in to your Bluesocket WLAN controller

At the top click on Configuration and then on the left, under External Authentication click on Accounting

Click on Create Accounting Server and enter the following:

  • Name: Acct1
  • Enabled: Ticked
  • IP Address: Select one
  • Port: 1813
  • Shared Secret: Available in the Edit Hotspot page in the Marketing4WiFi dashboard, called RADIUS Secret in the dashboard.
  • Shared Secret Confirmation: as above
  • Timeout: 5
  • Retries: 5
  • Interim Updates Enabled: Ticked
  • Interim Update Interval: 300

Click Create Accounting Server

Click on Create Accounting Server again and enter the following:

  • Name: Acct2
  • Enabled: Ticked
  • IP Address: Select one
  • Port: 1813
  • Shared Secret: Available in the Edit Hotspot page in the Marketing4WiFi dashboard, called RADIUS Secret in the dashboard.
  • Shared Secret Confirmation: as above
  • Timeout: 5
  • Retries: 5
  • Interim Updates Enabled: Ticked
  • Interim Update Interval: 300

Click Create Accounting Server


Next, on the left, under External Authentication click on Servers. Click on Create Authentication Server and enter the following:

  • Type: RadiusWebAuthServer
  • Name: Auth1
  • Accounting Server: Acct1
  • IP Address: Select one
  • Port: 1812
  • Shared Secret: Available in the Edit Hotspot page in the Marketing4WiFi dashboard, called RADIUS Secret in the dashboard.
  • Shared Secret Confirmation: as above
  • Timeout Weight: 1
  • Precedence: Highest
  • Role: Guest

Click on Create Authentication Server.

Click on Create Authentication Server again and enter the following:

  • Type: RadiusWebAuthServer
  • Name: Auth2
  • Accounting Server: Acct2
  • IP Address: Select one
  • Port: 1812
  • Shared Secret: Available in the Edit Hotspot page in the Marketing4WiFi dashboard, called RADIUS Secret in the dashboard.
  • Shared Secret Confirmation: as above
  • Timeout Weight: 1
  • Precedence: Lowest
  • Role: Guest

Click on Create Authentication Server.


Next, on the left under Captive Portal, click on Forms. Click Create Login Form and enter the following:

  • Name: SmartWiFi
  • Allow User Logins: Ticked
  • Allow Guest Logins: Unticked
  • Redirect Clients to an External URL: Ticked
  • Base URL of External Server: Select one
  • Clients Access Point MAC Address: ap
  • Client’s Access Point Name: ap_name
  • vWLAN IP Address: controller
  • Client’s Original URL: destination
  • Client’s MAC Address: mac
  • Client’s IP Address: source
  • Client’s Access Point SSID: ssid
  • Client’s VLAN ID: vlan
  • Double Encoding of URI Parameters: Unticked
  • Include RADIUS Option Vendor option: Unticked

Click on Create Login Form.


Next, on the left, under Role Based Access Control click on Destinations. Click on Create Destination Hostname and enter:

Create a Destination Hostname for all the entries in the Default walled garden entries.

If you’re a white label client and you have your own splash domain, be sure to include it in the walled garden.


Next, on the left, click on Destination Groups. Click on Create Destination Group.

  • Name: SmartWiFi
  • Destinations: Click the + sign beside each domain on the right hand list to add all of these to the left list. Be sure not to add the “Any” rule.

Click Create Destination Group

Next, on the left, click on Roles. Click on the Un-registered role. At the bottom, click on Append Firewall Rule and choose:

  • Policy: Allow
  • Service: Any
  • Direction: Both Ways
  • Destination: under “Destination Groups” choose SmartWiFi

Click Update Role.

Next, on the left, click on Roles. Click on the Guest role.

Under the Bandwidth Shaping section, enter:

QoS Rate In: Enter the desired download speed for guests.

QoS Rate Out: Enter the desired upload speed for guests.

Adtran Bluesocket vWLAN controllers do not support radius bandwidth throttling. You will need to set configure throttling on the controller level or set to 0 to disable bandwidth throttling to guests.

Under the Post Login Redirection section, enter:

URL Redirect: Select one

Click Update Role to save.


Next, on the left, under Wireless click on SSIDs. Click on Create SSID and enter the following:

Name: Smart WiFi (Or whatever you wish, this is what guests will see when connecting to WiFi)

Broadcast SSID: Ticked

Enable Captive Portal Authentication: Ticked

Authentication: Open System

Cipher: Disabled

Un-registered Role: Un-registered

Login Form: SmartWiFi

Click on Create SSID.

Finally, you need to apply this new configuration to your AP’s in the usual way. For example, go to the Status tab at the top and choose Access Points. Highlight the ones you are using and click the Apply button.


Troubleshooting Splash page

  1. When presenting the splash page guests may see a SSL certificate error. Please see this article regarding Manufacturer SSL certificates.
  2. If a hotspot deactivated message is presented please ensure all the AP MACs have been properly added as gateways to the correct hotspot.
  3. If devices are redirected to the splash page URL but the page fails to load please ensure the Destination Group walled garden entries were all added correctly and applied to the correct role.

Disclaimer on hardware configuration guides in the KB:

This equipment has been integrated and tested in our labs with the Marketing4WiFi platform using the firmware versions below.

Bluesocket VWLAN Version 3.2.0.HA Build 650478

LIMITED HARDWARE SUPPORT: Hardware manufacturers frequently make changes to firmware, controllers and GUI’s. The information below may be out of date or images may be different and is to be used as a general reference guide. We do offer additional limited support to help with trouble-shooting and we highly recommend that you have a hardware support agreement and/or access to a hardware support engineering representative from the manufacturer.

Updated on May 3, 2021

Was this article helpful?

Need Support?
Can't find the answer you're looking for? Don't worry we're here to help!
CONTACT SUPPORT