Prerequisites

1. Access to the Ubiquiti Dashboard as a user with administrative privileges.
2. Supported Ubiquiti device. These access points have Hotspot 2.0 certification: 
   • UAP-AC-M-PRO
   • UAP-AC-LITE
   • UAP-AC-PRO
   • UAP-AC-IW
   • UAP-AC-M

   These access points are not supported:

   • UAP-nanoHD
   • UAP-FlexHD
   • UAP-BeaconHD
   • UAP-IW-HD
   • U6 series
3. Information about the assigned RADIUS servers (Server IP address, port numbers, shared secrets):
   1. Email or document that contains this information
      
      OR
      
      
   2. Access to the IronWiFi Management Console - Sign in or Open Account

About this guide

This guide describes how to set up and test your Ubiquiti UniFi environment so you can use it with IronWiFi Passpoint:  

• Log in to the Ubiquiti UniFi dashboard as a user with administrative privileges.
• Update Ubiquiti UniFi access points with firmware that supports Hotspot 2.0.
• Configure a secure RADIUS connection.
• Configure the wireless LAN.
• Troubleshoot the configuration.

Log in to the Ubiquiti UniFi Dashboard

To start the configuration process, log in to the Ubiquiti UniFi Dashboard as admin (https://unifi.ui.com/dashboard).  For existing environments with additional users, log in as a user with administrative privileges.

The Ubiquiti UniFi Dashboard appears.



Note: There are a number of options you can set. Only the options that require your input are shown. Default values are used for options that don’t need adjustment.

Update the access point firmware

Before starting the Hotspot 2.0 (HS 2.0) configuration, update the access points (APs) with firmware that supports Hotspot 2.0.  

Ubiquiti recommends that the UniFi access points run firmware version 4.3.13.11253 or later. Firmware versions before 4.3.13.11253 don’t support Hotspot 2.0.

Network version 7.4 is missing the HotSpot 2.0 profiles page in the legacy UI. You can still create the SSID and select an existing HotSpot 2.0 profile, but you just can't make a new profile. You will have to downgrade to 7.3.* to create a new HS2.0 profile. 

 

Warning: Upgrading access point firmware is a disruptive event that introduces downtime during the upgrade process. It can take up to 15 minutes. Upgrade the firmware during a downtime or maintenance window.

 

1. Select Devices from the menu on the left side of the Ubiquiti UniFi Dashboard.
   
   
   
   Your access points display.
   
   
   
   If there’s an update available, an Upgrade option appears when you hover over each access point (along with the Locate and Restart options in list view). In grid view, a small upgrade icon appears to the upper right of each device.
   
   
2. Follow the firmware upgrade documentation provided by Ubiquiti based on the access points in your environment.

Switch to Legacy Interface

1. Select Settings at the bottom left of the Dashboard.
   
   
2. Click System button, enable Legacy Interface checkbox and click Deactivate 

 

 

Configure the RADIUS Profile

1. Select Settings at the bottom left of the Dashboard.
   
   
   
   The Settings menu appears.
   
   
   
   
2. Select Profiles from the Settings menu and click + Create New RADIUS Profile 
   
   
   
   The Create New RADIUS Profile page appears.
   
   
   
   
3. Enter the RADIUS Profile Name, such as “IronWiFi_radius”.
4. (Optional) Check the box next to VLAN Support as applicable to the existing network.
5. Enter the RADIUS service values shown for the primary authentication server.
   

   RADIUS Primary IP Address:  value from the IronWiFi Console or email
   
   RADIUS Secondary IP Address:  value from the IronWiFi Console or email
   
   Port: value from the IronWiFi Console or email - authentication port
   
   Shared Secret: value from the IronWiFi Console or email

6. Click + Add Auth Server to add the secondary RADIUS authentication server.
7. Click the box next to Enable accounting. The Accounting section is below the RADIUS Auth Server section. The RADIUS accounting server options appear.
   
   
   
   
   
8. Check the box next to Enable Interim Update and change the value to 300 (seconds).
   
   
9. Enter the RADIUS service values for the primary RADIUS accounting server.
   
   

   RADIUS Primary IP Address:  value from the IronWiFi Console or email
   
   RADIUS Secondary IP Address:  value from the IronWiFi Console or email
   
   Port: value from the IronWiFi Console or email - accounting port
   
   Shared Secret: value from the IronWiFi Console or email

10. Click + Add Accounting Server to add the secondary RADIUS accounting server.
11. Click Save at the bottom left.

A message appears at the top right indicating that the RADIUS profile changes are saved.

 

Configure the wireless LAN

Configure Hotspot 2.0

Hotspot 2.0 allows mobile devices to join a network automatically, including during roaming, when the devices enter the Hotspot 2.0 area.

The Hotspot 2.0 configuration is quite long. You can go through the whole configuration all at once or save changes after each major section and then edit the saved configuration.

1. Select Settings at the bottom left of the Dashboard.
   
   
   
   The Settings menu appears.
   
   
   
   
2. Select Services.
   
   You might see a message indicating that you need to connect a UniFi Security Gateway to enable the RADIUS configuration. Ignore that message and continue to the Hotspot2.0 configuration.
   
   
3. Click HOTSPOT 2.0 on the menu bar at the top of the page.
   
   
   
   
   
4. Click + Create New Hotspot 2.0 Profile and the Create New Hotspot 2.0 Profile page appears. Enter the Hotspot 2.0 Profile Name, such as “IronWiFi_hotspot”.
   
   
   
5. Expand INTERWORKING INFORMATION by clicking > next to it.
6. For Network Type, select Free public network and for Network Access, click the box next to Internet.
   
   
7. Scroll down to ONLINE SIGN-UP RELATED SETTINGS and enter the OSU SSID, such as “osu”. It can be any non-zero value. Leaving it blank stops the SSID broadcast.
   
   Note: Online Sign-up isn’t used in IronWiFi. This is just a required setting to make IronWiFi Passpoint work on Ubiquiti.
   
   
8. Scroll down to Venue Information.
9. For Venue Group and Venue Type, select the most appropriate values, such as Business and Professional Office, respectively.
10. Select a Language and enter a value for the Venue Name.
11. Click + Add Venue Name on the bottom right of Venue Information.
    
    
    
12. Expand OPERATOR FRIENDLY LIST by clicking > next to it.
13. Select a Language and for Text, enter the name of the Hotspot 2.0 operator, such as “IronWiFi”.
14. Click +Add Operator Friendly  Name on the bottom right of Operator Friendly Name List.
    
    
    
    
15. Expand NAI REALM LIST by clicking > next to it.
16. Click +Add NAI Realm. The Add NAI realm list entry dialog box appears.
    
17. Enter a Name, such as “IronWiFi” and click the box next to Realm Enabled.
18. For EAP Method, select EAP-TTLS, Non-EAP Inner Authentication as Auth Type and MSCHAPv2 and PAP as Auth Subtypes. For certificate authentication, select EAP-Method EAP-TLS.
    
    
    
    
19. Repeat the process for EAP-TLS method. For EAP Method, select EAP-TLS, Credential as Auth Type and Certificate as Auth Subtype.
    
    
20. Repeat the process for EAP-AKA method. For EAP Method, select EAP-AKA, Credential as Auth Type and SIM as Auth Subtype. 
    
    
    
    You can also add EAP-SIM and EAP-AKA' methods.
    
    
21. Expand DOMAIN NAME LIST by clicking > next to it.
22. For Name, enter the ironwifi.net and click +Add Domain Name.
    
    
23. For OpenRoaming, repeat the process and add the following domains:
    1. apple.openroaming.net
    2. google.openroaming.net
    3. openroaming.org
    4. ciscooneid.openroaming.net
    
    
    
    
    
24. Under ROAMING CONSORTIUM LIST, enter name ironwifi and Organization ID aa146b0000. Click + ADD ROAMING CONSORTIUM to confirm. 
    
    
25. For OpenRoaming, add the following organization ids:
    1. 5a03ba0000
    2. baa2d00000
    3. 004096
    
    
26. Scroll down to HOTSPOT2 WAN METRIC and select “Enable WAN metrics”.
27. Insert uplink and downlink speeds (such as 10000 Kbps). Ensure the Link Status is Up and make sure it is not marked as “At Capacity”.
    
    
28. Click Save at the bottom left.

A message appears at the top right indicating that the Hotspot 2.0 profile changes are saved.

Configure SSID with RADIUS profile and Hotspot 2.0 profile

If you're new to IronWiFi, we recommend creating a new SSID to avoid impacting any existing SSID configurations running in production.  

1. Select Wireless Networks from the Settings menu and click + Create New Wireless Network.
   
   
   
   
2. Enter Name/SSID, such as ‘unifi_hs20’
3. For Security, select WPA Enterprise. RADIUS profile options appear so you can associate the RADIUS profile with the wireless LAN.
4. Select the RADIUS Profile you created, “IronWiFi_radius”.
5. Click the box next to Enable Hotspot 2.0.
6. Select the Hotspot 2.0 profile you created, “IronWiFi_hotspot”.
   
   
   
   
7. Click Save at the bottom left.

A message appears at the top right indicating that the wireless network changes are saved.