This guide shows how to configure an Ubiquiti Networks managed controller in order to integrate access points with SpotOn.
This guide uses screenshots from the old controller UI. When using the newest UniFi controller version most settings will be located elsewhere. We suggest using the classic UI for people unfamiliair with the UniFi controller software. This can be selected at the top of the settings page:
Disable this feature:
This article applies to Ubiquiti Unifi SDN Controller with Firmware release 5.11.39 or later versions. It is required to work with these versions to be fully compatible with SpotOn. The access points need to have firmware 4.0.54 or later. (We recently (13-7-2021) tested controller firmware release 6.2.26 with AP firmware 4.3.28. This combination works flawless)
For Ubiquiti UniFi deployments to work with SpotOn’s Ubiquiti integration the following is required:
For a remote UniFi controller, simply forward or open the ports.
For a locally hosted UniFi controller in a different network other than the guest network, traffic from the guest network to the controller on port 8880 and 8843 needs to be allowed, as well as established/related traffic to make sure the UniFi controller can respond the client devices on the guest network.
You may choose to configure the device to automatically receive and install last firmware updates.
You will require a RADIUS password and a Custom URL from the SpotOn Support team. Chat with us, send an e-mail ([email protected]) or give us a call (050 211 5201).
To set up your SSID, go to Settings > Wireless Networks and create or edit your wireless network with the following settings. Make sure to check the “Apply guest policies (captive portal, guest authentication, access)”
Go to Settings > Guest Control.
Find the Guest Policies tab and configure the options as follows:
Find the PORTAL CUSTOMIZATION tab and set:
Find the Hotspot tab, check Enable RADIUS-based authorization and uncheck all the other options.
Scroll down to the RADIUS-tab.
To set up your SSID, click on Create new RADIUS profile and create your RADIUS server configuration.
It is necessary to check Enable accounting and Enable Interim Update, and set RADIUS Auth Server and RADIUS Accounting Server accordingly with the data specified below:
RADIUS Auth-server
IP-address: 94.124.94.160 ; Port: 1812
RADIUS Accounting Server
IP-address: 94.124.94.160 ; Port: 1813
RADIUS password / Shared Secret:
Ask the SpotOn team for the RADIUS password
Save your new Radius Profile.
Under Guest Control tab go to Pre-Authorization Access section and enter the required entries.
Under Site, enable Auto-Optimize Network.
In order to correctly redirect guests to our Splash Page, it is necessary to download the controller files onto the controller server.
Ask the SpotOn team for your custom URL.
After this step, you can extract the controller files. The destination path depends on the OS which hosts your Controller.
After completion check if spoton_unifi.js contains the Custom URL to our Splash page.
*Contact the SpotOn team to recieve your Custom URL.
var spotonPortal="PLACE_CUSTOM_URL_HERE";
If you are using a hosting service (e.g. Hostifi) for the controller and don’t have access to the server, contact your provider to upload the necessary files in the right directory.
In case you have a Cloud Key: