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.
Before you begin
Section titled “Before you begin”- The controller IP that sends RADIUS, for example
10.0.0.2. - The Airgate RADIUS address (
203.0.113.10in the examples) and a shared secret. - For guests: the Airgate portal host (for example
airgate.contoso.com, address203.0.113.20) reachable from the guest VLAN.
Step 1: Add the controller in Airgate
Section titled “Step 1: Add the controller in Airgate”- Go to Network › Switches and APs › Add device.
- Name
mc1, IP address or subnet10.0.0.2. - Vendor profile: Aruba AOS 8 Mobility Controller / Conductor. The dictionary becomes
Aruba, the CoA port3799. - On RADIUS, CoA & RadSec: enter the RADIUS shared secret, keep Require Message-Authenticator in Access-Requests on, turn on RADIUS CoA / Disconnect (RFC 5176).
- 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).
Step 3: 802.1X SSID
Section titled “Step 3: 802.1X SSID”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 20Create 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 30switchip-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.
Verify
Section titled “Verify”show user-tableon the controller lists the client with the role Airgate sent.- Monitor › Sign-in log shows the request from
mc1with theAruba-User-Roleon the Output tab. - On Monitor › Connected now, choose Disconnect. The result is
Disconnect-ACK.
Troubleshooting
Section titled “Troubleshooting”| 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. |