Cisco Catalyst switches (IOS-XE)
This page configures a Cisco Catalyst switch running IOS-XE (Catalyst 9200, 9300, 9400 and similar) for 802.1X and MAC authentication bypass (MAB) against Airgate, CoA from Airgate, and wired guest access with central web authentication (CWA) through the Airgate portal.
Before you begin
Section titled “Before you begin”- The switch management address, for example
10.0.0.2onVlan10. - The Airgate RADIUS address (
203.0.113.10in the examples) and a shared secret. - NTP configured on the switch.
- For guests: the address of the Airgate portal host (
203.0.113.20in the examples) and a guest portal on Guests › Guest portal.
Step 1: Add the switch in Airgate
Section titled “Step 1: Add the switch in Airgate”- Go to Network › Switches and APs › Add device.
- Name
access-sw1, IP address or subnet10.0.0.2. - Vendor profile: Cisco IOS-XE switch (Catalyst 9k, IBNS). The dictionary becomes
Cisco. - On RADIUS, CoA & RadSec: enter the RADIUS shared secret, keep Require Message-Authenticator in Access-Requests on, turn on RADIUS CoA / Disconnect (RFC 5176) and set CoA port to
3799(the profile default is the IOS default1700; this page configures3799). - Select Save.
Step 2: AAA and RADIUS server
Section titled “Step 2: AAA and RADIUS server”aaa new-model!radius server AIRGATE address ipv4 203.0.113.10 auth-port 1812 acct-port 1813 key <shared-secret>!aaa group server radius AIRGATE-GROUP server name AIRGATE ip radius source-interface Vlan10!aaa authentication dot1x default group AIRGATE-GROUPaaa authorization network default group AIRGATE-GROUPaaa accounting identity default start-stop group AIRGATE-GROUPaaa accounting update newinfo periodic 15!radius-server attribute 6 on-for-login-authradius-server attribute 8 include-in-access-reqradius-server attribute 25 access-request includeradius-server attribute 31 mac format ietf upper-caseradius-server attribute 31 send nas-port-detail mac-onlyradius-server vsa send authenticationradius-server vsa send accountingattribute 8sends the client IP (Framed-IP-Address),attribute 31sends the MAC asCalling-Station-Idin theAA-BB-CC-DD-EE-FFformat.aaa accounting update newinfo periodic 15sends interim updates when the client IP is learned and every 15 minutes.
Step 3: CoA (dynamic authorization)
Section titled “Step 3: CoA (dynamic authorization)”aaa server radius dynamic-author client 203.0.113.10 server-key <shared-secret> port 3799 auth-type anyAirgate’s CoA actions for this profile: Reauthenticate (subscriber:command=reauthenticate), Disconnect, Bounce port (subscriber:command=bounce-host-port) and Disable port. Every session identifier Airgate sends must match the switch’s session (otherwise the switch answers NAK, error 407); Airgate takes them from accounting, so keep accounting on.
Step 4: 802.1X and MAB on access ports
Section titled “Step 4: 802.1X and MAB on access ports”dot1x system-auth-control!device-tracking policy AIRGATE-IPDT tracking enable!interface GigabitEthernet1/0/10 description user port switchport mode access switchport access vlan 10 device-tracking attach-policy AIRGATE-IPDT authentication host-mode multi-auth authentication order dot1x mab authentication priority dot1x mab authentication port-control auto authentication periodic authentication timer reauthenticate server mab dot1x pae authenticator dot1x timeout tx-period 10 spanning-tree portfast- Device tracking (IPDT) learns client IP addresses for accounting and for the redirect.
authentication timer reauthenticate serverhonours theSession-TimeoutAirgate sends.- Airgate returns a VLAN with
Tunnel-Type,Tunnel-Medium-Type,Tunnel-Private-Group-Id, a named ACL withFilter-Id, or AV pairs withCisco-AVPair(for example a downloadable ACL withCisco-IP-Downloadable-ACL). Build them on Access › Enforcement profiles with the VLAN Enforcement, Filter-Id Enforcement, Cisco RADIUS Enforcement or Cisco Downloadable ACL templates.
Step 5: Guest access with central web authentication (optional)
Section titled “Step 5: Guest access with central web authentication (optional)”MAB returns a redirect ACL and the portal URL; after sign-in, Airgate caches the MAC and sends CoA Reauthenticate, and the next MAB matches the guest policy.
ip http serverip http secure-serverip http active-session-modules noneip http secure-active-session-modules none!ip access-list extended ACL-REDIRECT deny udp any any eq domain deny udp any any eq bootps deny tcp any host 203.0.113.20 eq 443 permit tcp any any eq www permit tcp any any eq 443In a redirect ACL, permit means “redirect” and deny means “do not redirect”. The port must also let DNS, DHCP and the portal traffic through (default port ACL or a downloadable ACL).
In Airgate:
-
On Access › Enforcement profiles, create a profile from the Cisco RADIUS Enforcement template with two
Cisco-AVPairrows:url-redirect-acl=ACL-REDIRECTurl-redirect=https://airgate.contoso.com/portal/<tenant>/<portal>?mac=%{Connection:Client-Mac-Address-Colon}
IOS-XE appends no client MAC to the redirect, so the
?mac=parameter is required. -
On the portal’s Login & network section: Vendor handling = Cisco IOS-XE / C9800 CWA, Login model = MAC caching + CoA, Post-login CoA = Reauthenticate (or Bounce port when the VLAN changes).
-
In the guest access policy, send the redirect profile to unknown MAB devices and the guest profile to devices with a valid guest login. See Guest portal.
Verify
Section titled “Verify”show access-session interface Gi1/0/10 detailsshows the method (dot1xormab), the statusAuthorizedand the attributes Airgate sent.- Monitor › Sign-in log shows the request from
access-sw1. - On Monitor › Connected now, choose Reauthenticate. The result is
CoA-ACK;show access-sessionshows a new authentication.
Troubleshooting
Section titled “Troubleshooting”| Symptom | Cause | Fix |
|---|---|---|
| No request in the Sign-in log | The switch sends from another interface | Set ip radius source-interface to the registered address. |
CoA timeout |
CoA port in Airgate is 1700 but the switch listens on 3799, or the client entry is missing |
Make the ports match; add client 203.0.113.10 under aaa server radius dynamic-author. |
CoA CoA-NAK |
Session identifiers do not match (error 407) | Keep accounting on so Airgate knows the audit-session-id; check show aaa sessions. |
| Guest is not redirected | ip http server / ip http secure-server missing, or no IP learned for the client |
Enable the HTTP server; attach the device-tracking policy. |
| Portal cannot identify the device | The url-redirect has no ?mac= parameter |
Add ?mac=%{Connection:Client-Mac-Address-Colon}. |