Ubiquiti UniFi with Cloud Key

The compatibility of the Ubiquiti UniFi system with the SOCIFI platform was tested on the controller version 5.4.11 (Build: atag_5.4.11_9184) and UniFi AP version This manual presumes a preconfigured controller with associated APs.

Important notice

The release of the Unifi Controller Firmware 5.10.12 is not compatible with SOCIFI at this moment. Please DO NOT UPGRADE to this version. If the the firmware is already updated to the latest version, please rollback the firmware to the previous version to keep the SOCIFI external portal service running.

We will inform you when the necessary changes are done and when the new version of the FW is compatible.

Information Update

The issue was caused by a bug on the firmware for APs in 5.10.12 and should be fixed in version 5.10.16

See https://community.ubnt.com/t5/UniFi-Updates-Blog/UniFi-Network-Controller-5-10-16-Stable-Candidate-has-been/ba-p/2674811 section bugfixes, Fix external guest portal cookies.

Information Update

The Ubiquiti community confirmed the bug was not definitely resolved in 5.10.16
Now the community announced resolving the bug in 5.10.17, However, the same issue was reported again on Ubiquiti portal.

As reported from users the issue was resolved after keeping the controller version on 5.10.16 or 5.10.17 and downgrading the firmware of the APs to 4.0.15 See

1. Guest Control

1.1 Guest Policies

Login to the UniFi Controller and Click on "Settings" - "Guest Control"

Set the Guest Policies options with the following values:

Enable Guest Portalchecked
AuthenticationExternal portal server
Custom Portal IP AddressAccording to geolocation table (see below)
Use Secure Portalunchecked
Redirect using hostnamehttp://connect-ip.socifi.com
Enable HTTPS Redirectionunchecked

Portal IP selection table according to geolocation:

Europe, Africa, Middle East52.51.203.246
North America52.44.151.156

1.2 Access Control

Under the Access Control section click "Add Hostname or Subnet" and enter the allowed subnet. Repeat this for all SOCIFI and CDN required subnets. Even if entering a hostname is allowed, the DNS translation functionality is limited and not recommended by SOCIFI.

List of IP addresses needed for SOCIFI service

IP / range

List of IP ranges for use with SOCIFI serviceList of IP ranges for enabling social networks login


Due to the problems with the activation of the captive portal on IP-based Walled Garden systems with many allowed IP ranges, add these ranges only if you want to use the Social Network Login.

Generally, we cannot recommend using the Social Network Login on IP-based hotspot systems.

2.1 Profiles

2.1 RADIUS Profiles

Click on "Profiles". Under the section "Radius Profiles" click on "Create New Radius Profile". Set the RADIUS Auth Servers with following options:

Profile Namead lib
RADIUS Auth Server
IP addresssee bellow for RADIUS server selection
Password/Sh. Secretsocifi

Click on "Add Auth Server" and repeat procedure for the secondary Auth server.

Check the option "Enable Accounting". Set the RADIUS Accounting Servers with following options:

RADIUS Accounting Server
IP addresssee bellow for RADIUS server selection
Password/Sh. Secretsocifi

Click on "Add Accounting Server" and repeat procedure for the secondary Accounting server.

Click on "Save"

We recommend to use this set of RADIUS servers:

 List of RADIUS according to your location:
 For North America

RADIUS Server 1

rad-1-use-1.socifi.com or IP address:, Radius shared secret: socifi

RADIUS Server 2

rad-2-use-1.socifi.com or IP address:, Radius shared secret: socifi

 For Europe and Africa

RADIUS Server 1

rad-1-euw-1.socifi.com or IP address:, Radius shared secret: socifi

RADIUS Server 2

rad-2-euw-1.socifi.com or IP address:, Radius shared secret: socifi

 For Asia-Pacific

RADIUS Server 1

rad-1-euw-1.socifi.com or IP address:, Radius shared secret: socifi

RADIUS Server 2

rad-2-euw-1.socifi.com or IP address:, Radius shared secret: socifi

In order to have the Radius communication working fine, the IP addresses (above) and the ports 1812 Auth and 1813 Acc must be accessible.

3. Wireless Networks

Click on "Settings" - "Wireless Networks"

Select the SSID intended for use with SOCIFI and click on "Edit". 

Configure the network with the following values:

Name/SSIDad lib
Enabledchecked "Enable this wireless network"
SecurityOpen (recommended)
Guest Policychecked "Apply guest policies"

4. Admins

Click on "Admins" and create a new admin profile for API communication. This account must be set in the SOCIFI Dashboard when adding a new Ubiquity hotspot

Click on "Add New Admin" and enter the following values:

Namead lib (eg. apiSOCIFI)
Invite to ControllerManually
Paswordenter a secure password
Require the user to change their passwordunchecked
Emailad lib
RoleSuper Administrator

Click on "Create"


Enablig API Access

It is necessary to forward the TCP port 8443 to UniFi controller on your NAT service or to assign a public IP to the UniFi controller. This will allow to communicate the SOCIFI portal with UniFi API.

The access to the port shall be allowed for the following list of IP addresses:

Make sure your Firewall Settings are set correctly.

If you have a Firewall, it may or may not block the communication / connection to SOCIFI Servers (Captive Portal, API endpoints, RADIUS servers).

The following IP Addresses have to be passed thru the Firewall or any other blocking mechanism to successfully reach SOCIFI. Without allowing these IP Addresses to go thru your Firewall, your deployment cannot work properly.

API Access is used by Ruckus, Ubiquiti and ANTlabs devices



5. Registering in Dashboard

5.1 Locating the MAC for the registration in SOCIFI Dashboard.

Click on "Devices". The MAC address for registration is in the column "Device Name". All listed AP devices must be registered in SOCIFI Dashboard.

5.2 Hotspot Registering

Step 1: Login to SOCIFI Dashboard

Step 2: Click on the "Hotspots" tab on the left sidebar

Step 3: Click on the “Add a new hotspot” button located on the top right corner on the screen (pictured below)

Note: A pop-up window will appear (below)

Step 4: Select the Wi-Fi hardware manufacturer from the drop down menu

Step 5: Enter the serial number or MAC address (depending on the specific equipment manual) of your equipment. You can add multiple hotspots at once.

Step 6: Set your Network location (this step is essential for correct ad targeting)

Step 7: Set the API endpoint. Switch the API Set-up on and enter the API endpoint formated as https://(CreatedAdminUsername):(Password)@(yourWANIP):8443

Step 8: In the pop-up window type your location or just move the marker on the map and click on the save button to confirm the selection. This address is used for ad GEO targeting.

Step 9: Click Save

Note: Newly added hotspot are marked as  (Hotspot pending). After the first user connects to the hotspot via SOCIFI, the status will automatically change and appear as  (Active) within an hour. Get your first connections to test if it works properly.