Skip to content

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.

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.
  • 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.10 in the examples) and a shared secret.
  1. Go to Network › Switches and APs › Add device.
  2. Name unifi-site1, IP address or subnet 10.0.10.0/24.
  3. Vendor profile: Ubiquiti UniFi. The dictionary becomes IETF; no CoA port is set because UniFi has no RADIUS CoA.
  4. On RADIUS, CoA & RadSec: enter the RADIUS shared secret. Leave RADIUS CoA / Disconnect (RFC 5176) off.
  5. 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.
  6. Select Save.

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

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.

  1. In Settings › Networks (or Profiles › Switch ports), enable 802.1X control for the site and choose the Airgate RADIUS profile.
  2. On the port profile for user ports, set 802.1X control to Auto (or MAC-based for MAC authentication).
  1. Monitor › Sign-in log shows requests from the AP or switch addresses in 10.0.10.0/24.
  2. In UniFi Network, the client shows the VLAN Airgate sent.
  3. 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.
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.
© 2026 Airowire Networks Pvt. Ltd. Airgate is a product of Airowire.Product · Release notes · Security