Skip to content

Aruba Mobility Controller (AOS 8)

This page configures an ArubaOS 8 Mobility Controller (managed by a Mobility Conductor, or standalone) to authenticate Wi-Fi users and devices against Airgate, accept CoA and Disconnect, and send guests to the Airgate portal. Airgate assigns roles with Aruba-User-Role and VLANs with the RFC 3580 attributes, Aruba-User-Vlan or Aruba-Named-User-Vlan.

  • The controller IP that sends RADIUS, for example 10.0.0.2.
  • The Airgate RADIUS address (203.0.113.10 in the examples) and a shared secret.
  • For guests: the Airgate portal host (for example airgate.contoso.com, address 203.0.113.20) reachable from the guest VLAN.
  1. Go to Network › Switches and APs › Add device.
  2. Name mc1, IP address or subnet 10.0.0.2.
  3. Vendor profile: Aruba AOS 8 Mobility Controller / Conductor. The dictionary becomes Aruba, the CoA port 3799.
  4. On RADIUS, CoA & RadSec: enter the RADIUS shared secret, keep Require Message-Authenticator in Access-Requests on, turn on RADIUS CoA / Disconnect (RFC 5176).
  5. Select Save.

Add every controller that terminates users, each with its own address.

Step 2: RADIUS server, server group and RFC 3576

Section titled “Step 2: RADIUS server, server group and RFC 3576”
aaa authentication-server radius Airgate
host 203.0.113.10
key <shared-secret>
authport 1812
acctport 1813
nas-ip 10.0.0.2
!
aaa server-group Airgate-SG
auth-server Airgate
!
aaa rfc-3576-server 203.0.113.10
key <shared-secret>

The controller listens for RFC 3576 (CoA and Disconnect) on UDP 3799. The rfc-3576-server must also be attached to each AAA profile (step 3).

aaa authentication dot1x Corp-dot1x
!
aaa profile Corp-AAA
authentication-dot1x Corp-dot1x
dot1x-server-group Airgate-SG
radius-accounting Airgate-SG
radius-interim-accounting
rfc-3576-server 203.0.113.10
!
wlan ssid-profile Corp-WiFi
essid Corp-WiFi
opmode wpa2-aes
!
wlan virtual-ap Corp-WiFi
aaa-profile Corp-AAA
ssid-profile Corp-WiFi
vlan 20

Create every role you return in Aruba-User-Role as user-role <name> on the controller.

Step 4: Guest SSID with the Airgate captive portal

Section titled “Step 4: Guest SSID with the Airgate captive portal”

The controller MAC-authenticates the device, Airgate returns the captive-portal role, the role redirects to the Airgate portal, and the portal posts the guest’s credentials to https://<controller>/cgi-bin/login. The controller then sends a RADIUS PAP request through the captive-portal server group, and Airgate answers with the guest role.

netdestination Airgate-Portal
host 203.0.113.20
!
aaa authentication captive-portal Airgate-CP
login-page https://airgate.contoso.com/portal/<tenant>/<portal>
server-group Airgate-SG
white-list Airgate-Portal
switchip-in-redirection-url
!
aaa authentication mac Guest-mac
!
user-role Airgate-Guest-Portal
access-list session logon-control
access-list session captiveportal
captive-portal Airgate-CP
!
aaa profile Guest-AAA
initial-role Airgate-Guest-Portal
authentication-mac Guest-mac
mac-server-group Airgate-SG
radius-accounting Airgate-SG
radius-interim-accounting
rfc-3576-server 203.0.113.10
!
wlan ssid-profile Corp-Guest
essid Corp-Guest
opmode opensystem
!
wlan virtual-ap Corp-Guest
aaa-profile Guest-AAA
ssid-profile Corp-Guest
vlan 30

switchip-in-redirection-url adds the controller address (switchip) to the redirect; Airgate needs it to post the login.

In Airgate, on the portal’s Login & network section (Guests › Guest portal):

Field Value
Vendor handling Aruba (AOS 8 / Instant / AOS 10) or Auto-detect
Login model Web login
Redirect MAC trust Signed with the URL hash key of the captive-portal profile (when you set one), else Session

Create enforcement profiles from the Aruba RADIUS Enforcement template for the portal role and the guest role.

  1. show user-table on the controller lists the client with the role Airgate sent.
  2. Monitor › Sign-in log shows the request from mc1 with the Aruba-User-Role on the Output tab.
  3. On Monitor › Connected now, choose Disconnect. The result is Disconnect-ACK.
Symptom Cause Fix
CoA timeout rfc-3576-server missing in the AAA profile, or the key differs Attach the RFC 3576 server to every AAA profile with the same secret.
Role not applied, user gets the default role The role sent in Aruba-User-Role is not defined Create the user-role with that exact name.
Portal login fails with no login host switchip-in-redirection-url missing Add it to the captive-portal profile.
Portal page does not load The portal host is not allowed before login Add the portal host as white-list netdestination.
© 2026 Airowire Networks Pvt. Ltd. Airgate is a product of Airowire.Product · Release notes · Security