Skip to content

Aruba CX switches

This page configures an Aruba AOS-CX switch (CX 6000, 6100, 6200, 6300, 6400 and later) for port-based 802.1X and MAC authentication against Airgate, dynamic authorization (CoA) from Airgate, and wired guest access through the Airgate portal. Roles are assigned with Aruba-User-Role, VLANs with the RFC 3580 attributes.

  • AOS-CX 10.08 or later is recommended (local user roles, captive-portal profiles).
  • The Airgate RADIUS address (203.0.113.10 in the examples) and a shared secret.
  • The switch management address, for example 10.0.0.2, reachable from Airgate on UDP 3799 for CoA (or a site connector on the LAN).
  • NTP configured on the switch.
  1. Go to Network › Switches and APs › Add device.
  2. Name access-sw1, IP address or subnet 10.0.0.2.
  3. Vendor profile: Aruba AOS-CX switch. 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.
radius-server host 203.0.113.10 key plaintext <shared-secret>
radius-server host 203.0.113.10 tracking enable
ip source-interface radius interface vlan10
!
aaa group server radius AIRGATE
server 203.0.113.10
!
aaa accounting port-access start-stop interim 10 group AIRGATE

Use vrf mgmt on the radius-server host line when the switch reaches Airgate through the management port.

aaa authentication port-access dot1x authenticator
radius server-group AIRGATE
enable
aaa authentication port-access mac-auth
radius server-group AIRGATE
enable
!
client track ip
!
interface 1/1/10
no shutdown
no routing
vlan access 10
aaa authentication port-access client-limit 4
aaa authentication port-access dot1x authenticator
enable
aaa authentication port-access mac-auth
enable
  • client track ip lets the switch learn client IP addresses and report them in accounting.
  • Airgate returns Aruba-User-Role (a local role on the switch, or a downloadable role), Aruba-NAS-Filter-Rule, or a VLAN with Tunnel-Type, Tunnel-Medium-Type and Tunnel-Private-Group-Id. Create local roles with port-access role <name>.
radius dyn-authorization enable
radius dyn-authorization client 203.0.113.10 secret-key plaintext <shared-secret>

The switch listens on UDP 3799. Airgate’s CoA actions for this profile are Disconnect, Bounce port (Aruba-Port-Bounce-Host) and changing attributes (for example a new Aruba-User-Role).

For wired guests, Airgate uses MAC caching + CoA: MAC authentication returns a role bound to a captive-portal profile; after sign-in, Airgate caches the MAC and sends CoA, and the next MAC authentication returns the guest role.

aaa authentication port-access captive-portal-profile Airgate-CP
url https://airgate.contoso.com/portal/<tenant>/<portal>
url-hash-key plaintext <hash-key>
!
class ip Portal-Allow
10 match udp any any eq 53
20 match udp any any eq 67
30 match tcp any 203.0.113.20 eq 443
class ip Portal-Redirect
10 match tcp any any eq 80
20 match tcp any any eq 443
!
port-access policy Airgate-Guest-Portal
10 class ip Portal-Allow action permit
20 class ip Portal-Redirect action redirect captive-portal
!
port-access role Airgate-Guest-Portal
associate captive-portal-profile Airgate-CP
associate policy Airgate-Guest-Portal
vlan access 30
!
port-access role Guest-Internet
vlan access 30

Replace 203.0.113.20 with the address of the Airgate portal host.

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

Field Value
Vendor handling Aruba switch (AOS-CX / AOS-S)
Login model MAC caching + CoA
Post-login CoA Reauthenticate, or Bounce port when the guest VLAN changes
Redirect MAC trust Signed, with URL hash key = the url-hash-key above (recommended)

Create the enforcement profiles Aruba-User-Role = Airgate-Guest-Portal and Aruba-User-Role = Guest-Internet from the Aruba RADIUS Enforcement template on Access › Enforcement profiles.

  1. Connect a client to 1/1/10. show port-access clients shows it authenticated by dot1x or mac-auth with the expected role.
  2. Monitor › Sign-in log shows the record with Switch / AP = access-sw1.
  3. On Monitor › Connected now, choose Bounce port for the session. The result is CoA-ACK and the port flaps.
Symptom Cause Fix
No request in the Sign-in log Wrong RADIUS source address Set ip source-interface radius to the address registered in Airgate.
Client authorized but in the wrong role The role named in Aruba-User-Role does not exist on the switch Create the port-access role with that exact name.
CoA timeout radius dyn-authorization not enabled, or the client entry has another secret Enable it and use the same secret as in Airgate.
Guest portal refuses the device as untrusted The redirect MAC had no recent RADIUS activity, or the hash key differs Check Redirect MAC trust and the URL hash key.
© 2026 Airowire Networks Pvt. Ltd. Airgate is a product of Airowire.Product · Release notes · Security