Ubiquiti Unifi API Configuration

The following instructions outline how to setup a Ubiquiti UniFi network for the Smart WiFI 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.

1. 1. Log into the controller.
   2. Launch the correct site and click the settings icon in the bottom left.
   3. On the menu to the left click Guest Control and configure with
      • Enable Guest Portal: Checked
      • Authentication: Hotspot
      • Promotional URL: You will receive this
      •  Redirection-
        1. Use Secure Portal: Unchecked
        2. Redirect Using Hostname: Unchecked
        3. Enabled HTTPS Redirection: Unchecked
        4. Enable encrypted redirect URL: Unchecked
      • Template Engine: Angular JS
      • Override Default Templates: Checked
      • Pre-Authorization Access: Add all the Default walled garden entries.
        

        Please add any additional links provided with your order.

      • Press ‘Apply Changes’ to save.
   4. On the menu to the left click Wireless Networks.
      • Create a new Wireless Network or Edit your existing Guest WiFi network.
      • Check the Guest Policy box to enable the Guest Control settings.
   5. Final Step- Place the two HTML files you receive from support onto the Unifi controller hotspot directory for the correct site code.
      Typical file location examples are below.(depending on the UniFi controller): Please note you will typically use your site auto generated folder name instead of default.
      Dream Machine: /data/unifi/data/sites/default/app-unifi-hotspot-portal
      CloudKey: /srv/unifi/data/sites/default/app-unifi-hotspot-portal
      Windows: C:\Users\<username>\Ubiquiti UniFi\data\sites\default\app-unifi-hotspot-portal
      MAC: ~/Library/Application Support/UniFi/data/sites/default/app-unifi-hotspot-portal
      Linux: /usr/lib/unifi/sites/data/default/app-unifi-hotspot-portal
      
      

      You can find your site directory name by looking at the URL when viewing the site on the controller. If necessary please contact support for further assistance.

Troubleshooting Splash page

1. If devices are redirected but the device hangs on the controller url please ensure port 8880 is open to the Unifi Controller.
2. If devices are redirected and port 8880 is open to the controller please ensure that the ‘Secure Portal’ option is turned OFF.
3. If devices present an certificate error please ensure https redirection is disabled.
4. If a hotspot deactivated message is presented please ensure all the AP MACs have been added as gateways to the correct hotspot.
5. 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.
6. If the internal captive portal from the Unifi controller is displayed instead of the hotspot splash page make sure ‘Override Default Templates’ is ON and the index and auth files have been placed on the correct site directory.