Ubiquiti UniFi
This page configures UniFi access points and switches, in the UniFi Network application, to authenticate users and devices against Airgate. UniFi supports 802.1X, RADIUS MAC authentication and RADIUS-assigned VLANs, but no RADIUS CoA.
What works with UniFi
Section titled “What works with UniFi”| Feature | Support |
|---|---|
| 802.1X (WPA2/WPA3-Enterprise) | Yes |
| RADIUS MAC authentication on an SSID | Yes |
| RADIUS-assigned VLAN | Yes (RFC 3580 attributes) |
| Wired 802.1X on UniFi switches | Yes |
| RADIUS CoA / Disconnect | No. UniFi has no RADIUS CoA. A policy change takes effect at the next authentication. |
| Airgate guest portal | No. UniFi grants external-portal guests only through the controller API, which Airgate does not support. Use Wi-Fi passes or MAC authentication instead. |
Before you begin
Section titled “Before you begin”- The subnet your UniFi APs and switches are on, for example
10.0.10.0/24. Each device sends RADIUS from its own address. - The Airgate RADIUS address (
203.0.113.10in the examples) and a shared secret.
Step 1: Add the devices in Airgate
Section titled “Step 1: Add the devices in Airgate”- Go to Network › Switches and APs › Add device.
- Name
unifi-site1, IP address or subnet10.0.10.0/24. - Vendor profile: Ubiquiti UniFi. The dictionary becomes
IETF; no CoA port is set because UniFi has no RADIUS CoA. - On RADIUS, CoA & RadSec: enter the RADIUS shared secret. Leave RADIUS CoA / Disconnect (RFC 5176) off.
- Check Require Message-Authenticator in Access-Requests: keep it on if your UniFi release sends Message-Authenticator in MAC-authentication requests (check Monitor › Alerts and events and the Sign-in log after the first test); turn it off only if it does not.
- Select Save.
Step 2: RADIUS profile
Section titled “Step 2: RADIUS profile”In UniFi Network, go to Settings › Profiles › RADIUS and create a profile Airgate:
| Setting | Value |
|---|---|
| Authentication servers | 203.0.113.10, port 1812, shared secret |
| Accounting servers | 203.0.113.10, port 1813, shared secret |
| Interim update | On, 600 seconds |
| RADIUS assigned VLAN | On for wireless (and wired) networks when Airgate assigns VLANs |
Step 3: WPA-Enterprise SSID
Section titled “Step 3: WPA-Enterprise SSID”Go to Settings › WiFi and create Corp-WiFi:
- Security protocol: WPA2 Enterprise (or WPA3 Enterprise).
- RADIUS profile:
Airgate.
For devices without a supplicant, use a WPA2 Personal or open SSID with RADIUS MAC authentication turned on, the Airgate profile and the MAC address format aa:bb:cc:dd:ee:ff.
Step 4: Wired 802.1X (UniFi switches)
Section titled “Step 4: Wired 802.1X (UniFi switches)”- In Settings › Networks (or Profiles › Switch ports), enable 802.1X control for the site and choose the
AirgateRADIUS profile. - On the port profile for user ports, set 802.1X control to Auto (or MAC-based for MAC authentication).
Verify
Section titled “Verify”- Monitor › Sign-in log shows requests from the AP or switch addresses in
10.0.10.0/24. - In UniFi Network, the client shows the VLAN Airgate sent.
- To apply a policy change to a connected client, disconnect it from UniFi Network (Clients › the client › Disconnect / Block) or wait for re-authentication; Airgate cannot send CoA to UniFi.
Troubleshooting
Section titled “Troubleshooting”| Symptom | Cause | Fix |
|---|---|---|
| MAC authentication requests do not appear | No Message-Authenticator in the requests while Airgate requires it | Update UniFi, or turn off Require Message-Authenticator in Access-Requests for this device entry. |
| Requests from some APs missing | APs outside the registered subnet | Widen IP address or subnet or add another device entry. |
| VLAN not applied | RADIUS assigned VLAN is off | Turn it on in the RADIUS profile. |
Related
Section titled “Related”© 2026 Airowire Networks Pvt. Ltd. Airgate is a product of Airowire.Product · Release notes · Security