Why upgrade to the new Unifi API Integration?
With the Unifi API Integration your hotspots can fully utilize advanced login features like Guest Plans or Ad-Based login and provide guests the correct rate-limiting settings for the method used.
The following instructions outline how to setup a Ubiquiti UniFi network for the Marketing4WiFi Platform utilizing the API integration. This guide assumes that your Unifi 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.
- Launch the correct site in your Unifi controller and click the settings icon in the bottom left.
- On the menu to the left click Profiles.
- Click on the Default option under the Guest Hotspot section and configure with the following settings:
- Authentication Type: External Portal Server
- External Portal: 1.1.1.1
- Guest Landing Page: ON
- Advanced: Manual
- Landing Page: Select Promotional URLand use one of the following
- Redirection-
- Enabled HTTPS Redirection: Unchecked
- Enable encrypted redirect URL: Unchecked
- Use Secure Portal: Checked
- Redirect Using Hostname: Checked
- Allowed Authorization Access: Add all the Default walled garden entries.
- Press Apply Changes to save.
- On the menu to the left click Wireless Networks.
- Create a new Wireless Network or Edit your existing Guest WiFi network.
- WiFi Type: Guest Hotspot
- Press Apply Changes to save.
Troubleshooting Splash page
- If devices are redirected but the device hangs on the controller url please ensure port 8880 is open to the Unifi Controller.
- If devices present an certificate error please ensure https redirection is disabled.
- If a hotspot deactivated message is presented please ensure all the AP MACs have been added as gateways to the correct hotspot.
- If devices are redirected to the splash page URL but the page fails to load please ensure the Allowed Authorization Access list has been properly configured.