Ubiquiti UniFi

This page explains different configuration scenarios for Ubiquiti UniFi Controller with IronWifi - Captive Portal and WPA-Enterprise with external RADIUS authentication and accounting.

Configuring UniFi Controller for external Captive Portal authentication

IronWifi Console configuration

  1. Sign in to the Console
  2. Click on Networks and add a Network
  3. Click on Captive Portals and add a Captive Portal
  4. In the Captive Portal settings, add Authentication Provider - can be Anonymous for testing purpose
  5. IronWifi servers need to directly connect to your Controller (SW, Cloud Key) to authorize connecting devices. Enter the Controller URL or leave blank if the Controller public address is the same as connecting devices IP address (router public IP address). The controller URL should be in this format: - https://your_public_static_ip:8443. Make sure it is the PUBLIC IP address, and it's reachable through the Internet (not private address like 192.168.*.*, 172.16.*.*, or 10.*.*.*). You might need to configure port forwarding on your Internet router and firewall. If you are not sure, please consult with your ISP provider.
  6. Decide if you want to enable the Use Proxy feature. If enabled, we will be connecting to your controller from static IP addresses, or, or, but the authorization process will be a little slower. If you disable this feature, we will be connecting from dynamic IP range - https://cloud.google.com/appengine/kb/#static-ip and the client authorization process will be faster.
  7. Enter Controller username (administrator privileges, you can create a new user in your controller) and password.
  8. Enable Controller monitoring

Ubiquiti Controller configuration

  1. Sign-in to your Ubiquiti Controller
  2. In Wireless network settings change the Security to Open and enable Guest Services
  3. Navigate to Guest services settings
  4. Select External Captive Portal
  5. Enter in the IPv4 address input field
  6. Check the Use Secure Portal checkbox
  7. Check the redirect using hostname checkbox and enter the hostname from the Captive Portal settings page in IronWifi Console - for example, splashr-bem7i-wud54-re5up.ironwifi.com
  8. Uncheck the Enable HTTPS Redirection
  9. Add to the Pre-Authorization Access list
  10. Apply settings and try with your phone or computer



Configuring UniFi Controller for WPA-Enterprise

If you wish to have a WPA-Enterprise protected network without Captive Portal, navigate to Wireless Networks and change Security to WPA-Enterprise. Enter information about the RADIUS servers, IP addresses, ports, and shared secrets are available in IronWifi Console -> Networks.


Common Errors

Captive Portal can return different error codes in the error_message parameter.

  • unifi_authentication_failed - credentials configured in the Captive Portal settings are probably not valid. Sign in to the Ubiquiti Controller and create a new admin user and password. Configure this username and password in the Captive Portal configuration page in our Console.


  • 500 Gateway Timeout or unifi_gw_connection_failed - our servers could not connect to your Controller. Make sure the Controller is reachable over the internet, check your firewall settings and port forwarding rules if necessary. The controller should listen on port 8443/TCP.