Skip to content

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.

  • The switch management address, for example 10.0.0.2 on Vlan10.
  • The Airgate RADIUS address (203.0.113.10 in the examples) and a shared secret.
  • NTP configured on the switch.
  • For guests: the address of the Airgate portal host (203.0.113.20 in the examples) and a guest portal on Guests › Guest portal.
  1. Go to Network › Switches and APs › Add device.
  2. Name access-sw1, IP address or subnet 10.0.0.2.
  3. Vendor profile: Cisco IOS-XE switch (Catalyst 9k, IBNS). The dictionary becomes Cisco.
  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) and set CoA port to 3799 (the profile default is the IOS default 1700; this page configures 3799).
  5. Select Save.
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-GROUP
aaa authorization network default group AIRGATE-GROUP
aaa accounting identity default start-stop group AIRGATE-GROUP
aaa accounting update newinfo periodic 15
!
radius-server attribute 6 on-for-login-auth
radius-server attribute 8 include-in-access-req
radius-server attribute 25 access-request include
radius-server attribute 31 mac format ietf upper-case
radius-server attribute 31 send nas-port-detail mac-only
radius-server vsa send authentication
radius-server vsa send accounting
  • attribute 8 sends the client IP (Framed-IP-Address), attribute 31 sends the MAC as Calling-Station-Id in the AA-BB-CC-DD-EE-FF format.
  • aaa accounting update newinfo periodic 15 sends interim updates when the client IP is learned and every 15 minutes.
aaa server radius dynamic-author
client 203.0.113.10 server-key <shared-secret>
port 3799
auth-type any

Airgate’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.

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 server honours the Session-Timeout Airgate sends.
  • Airgate returns a VLAN with Tunnel-Type, Tunnel-Medium-Type, Tunnel-Private-Group-Id, a named ACL with Filter-Id, or AV pairs with Cisco-AVPair (for example a downloadable ACL with Cisco-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 server
ip http secure-server
ip http active-session-modules none
ip 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 443

In 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:

  1. On Access › Enforcement profiles, create a profile from the Cisco RADIUS Enforcement template with two Cisco-AVPair rows:

    • url-redirect-acl=ACL-REDIRECT
    • url-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.

  2. 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).

  3. 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.

  1. show access-session interface Gi1/0/10 details shows the method (dot1x or mab), the status Authorized and the attributes Airgate sent.
  2. Monitor › Sign-in log shows the request from access-sw1.
  3. On Monitor › Connected now, choose Reauthenticate. The result is CoA-ACK; show access-session shows a new authentication.
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}.
© 2026 Airowire Networks Pvt. Ltd. Airgate is a product of Airowire.Product · Release notes · Security