Skip to main content

Cisco WLC - Passpoint Configuration

Configure Passpoint (Hotspot 2.0) on Cisco AireOS WLC or Catalyst 9800 wireless controllers to enable automatic WiFi authentication through IronWifi's cloud RADIUS service. This provides seamless WPA2/WPA3-Enterprise connections without manual network selection or splash pages.

Supported Platforms

  • Cisco AireOS WLC - 5520, 8540, 3504, vWLC
  • Cisco Catalyst 9800 - 9800-40, 9800-80, 9800-CL
  • Cisco Embedded Wireless Controller

Prerequisites

In Cisco WLC:

  • Cisco WLC with AireOS 8.5+ or IOS-XE 17.x+
  • Access points supporting Hotspot 2.0 (Wave 2 or later)
  • Network connectivity to IronWifi RADIUS servers

In IronWifi Console (complete these first):

  1. Log in to IronWifi Management Console
  2. Navigate to Networks > select your network
  3. Enable Passpoint
  4. Note the RADIUS details and Passpoint configuration:
    • RADIUS Server IP
    • RADIUS Secret
    • Authentication Port: 1812
    • Accounting Port: 1813

AireOS WLC Configuration

Web Interface Configuration

Step 1: Configure RADIUS Server

  1. Log in to WLC web interface

  2. Go to Security > AAA > RADIUS > Authentication

  3. Click New

  4. Configure:

    • Server Index: 1
    • Server IP Address: IronWifi RADIUS IP
    • Shared Secret: Your RADIUS secret
    • Port Number: 1812
    • Server Status: Enabled
  5. Click Apply

  6. Go to Accounting and add accounting server:

    • Same IP, port 1813

Step 2: Create WLAN

  1. Go to WLANs
  2. Click Create New
  3. Configure:
    • Profile Name: Passpoint
    • SSID: Passpoint
    • ID: Select available ID
  4. Click Apply

Step 3: Configure WLAN Security

  1. Edit the new WLAN
  2. Go to Security > Layer 2:
    • Layer 2 Security: WPA+WPA2
    • WPA2 Policy: Enabled
    • WPA2 Encryption: AES
    • Auth Key Mgmt: 802.1X
  3. Go to Security > AAA Servers:
    • Authentication Servers: Select IronWifi server
    • Accounting Servers: Select IronWifi server

Step 4: Enable Hotspot 2.0

  1. Go to Advanced tab
  2. Find Hotspot 2.0 section
  3. Enable Hotspot 2.0
  4. Configure:

General:

  • Hotspot 2.0 Enable: Enabled
  • DGAF Disable: Disabled

Step 5: Configure 802.11u

  1. Go to Wireless > 802.11u
  2. Enable 802.11u
  3. Configure:

Network Settings:

  • Internet Access: Enabled
  • Network Type: Free public network
  • ASRA: Disabled

Venue Information:

  • Venue Group: Business
  • Venue Type: Unspecified
  • Venue Name: Your Location (Language: eng)

Step 6: Configure Roaming Consortium

  1. In 802.11u settings, find Roaming Consortium
  2. Add OIs:
    5A03BA0000
    004096

Step 7: Configure NAI Realm

  1. Go to NAI Realm section
  2. Add realm:
    • NAI Realm: ironwifi.com
    • EAP Method: EAP-TTLS
    • Inner Auth: PAP

Step 8: Configure Domain

  1. In Hotspot 2.0 settings
  2. Add Domain Name: ironwifi.net

AireOS CLI Configuration

# Configure RADIUS server
config radius auth add 1 1.2.3.4 1812 ascii your-secret
config radius auth enable 1
config radius acct add 1 1.2.3.4 1813 ascii your-secret
config radius acct enable 1

# Create WLAN
config wlan create 1 Passpoint Passpoint
config wlan security wpa wpa2 enable 1
config wlan security wpa wpa2 ciphers aes enable 1
config wlan security wpa akm 802.1x enable 1
config wlan radius_server auth add 1 1
config wlan radius_server acct add 1 1
config wlan enable 1

# Enable 802.11u
config wlan hotspot dot11u enable 1
config wlan hotspot dot11u internet-access enable 1
config wlan hotspot dot11u network-type free-public 1
config wlan hotspot dot11u venue-group business 1
config wlan hotspot dot11u venue-type unspecified 1

# Configure Roaming Consortium
config wlan hotspot dot11u roam-oi add 1 5A03BA0000 beacon
config wlan hotspot dot11u roam-oi add 1 004096

# Configure NAI Realm
config wlan hotspot dot11u nai-realm add 1 ironwifi.com
config wlan hotspot dot11u nai-realm eap-method add 1 ironwifi.com eap-ttls

# Configure Domain
config wlan hotspot dot11u domain add 1 ironwifi.net

# Enable Hotspot 2.0
config wlan hotspot hs2 enable 1

Catalyst 9800 Configuration

Web Interface (WebUI)

Configure RADIUS

  1. Go to Configuration > Security > AAA
  2. Click Servers/Groups > RADIUS
  3. Add server:
    • Name: IronWifi
    • IP Address: IronWifi RADIUS IP
    • Key: Your shared secret
    • Auth Port: 1812
    • Acct Port: 1813

Create Server Group

  1. Go to Server Groups
  2. Create new group
  3. Add IronWifi server to group

Configure Policy Profile

  1. Go to Configuration > Tags & Profiles > Policy
  2. Create new policy profile
  3. Configure AAA settings to use IronWifi

Configure WLAN

  1. Go to Configuration > Tags & Profiles > WLANs

  2. Create new WLAN:

    • Profile Name: Passpoint
    • SSID: Passpoint
    • Status: Enabled
  3. In Security tab:

    • Layer 2: WPA2
    • Auth Key Management: 802.1X
  4. In Advanced tab:

    • Enable Hotspot 2.0

Configure Hotspot 2.0

  1. Go to Configuration > Wireless > Hotspot 2.0
  2. Create HS2.0 Profile:

General Settings:

  • Profile Name: IronWifi-Passpoint
  • Internet Access: Enabled
  • Network Type: Free public

Venue:

  • Venue Group: Business
  • Venue Type: Unspecified

Domain:

  • Add: ironwifi.net

Roaming Consortium:

  • Add: 5A03BA0000
  • Add: 004096

NAI Realm:

  • Realm: ironwifi.com
  • EAP Method: EAP-TTLS
  • Inner Auth: PAP
  1. Assign profile to WLAN

Catalyst 9800 CLI Configuration

! RADIUS Configuration
radius server IronWifi
address ipv4 1.2.3.4 auth-port 1812 acct-port 1813
key your-secret

aaa group server radius IronWifi-Group
server name IronWifi

aaa authentication dot1x default group IronWifi-Group
aaa authorization network default group IronWifi-Group
aaa accounting identity default start-stop group IronWifi-Group

! Hotspot 2.0 Configuration
wireless hotspot anqp-server IronWifi-ANQP
network-type free-public
internet
venue-group business
venue-type unspecified
domain-name ironwifi.net
nai-realm ironwifi.com
eap-method eap-ttls
inner-auth-type pap
roaming-oi 5A03BA0000
roaming-oi 004096

wireless profile hotspot2 IronWifi-Passpoint
anqp-server IronWifi-ANQP
hs2-profile enable

! WLAN Configuration
wlan Passpoint 1 Passpoint
security wpa psk set-key ascii 0 disabled
security wpa wpa2
security wpa akm dot1x
security dot1x authentication-list default
hotspot2 IronWifi-Passpoint
no shutdown

! Policy Profile
wireless profile policy Passpoint-Policy
description Passpoint Policy Profile
aaa-override
nac
vlan VLAN_ID
no shutdown

! Tag Configuration
wireless tag policy Passpoint-Tag
wlan Passpoint policy Passpoint-Policy

Troubleshooting

Common Issues

Network Not Discovered

  1. Verify Hotspot 2.0 is enabled on WLAN
  2. Check 802.11u configuration
  3. Verify GAS/ANQP frames are being sent
  4. Check client Passpoint support

Authentication Failures

  1. Test RADIUS connectivity
  2. Verify NAI realm configuration
  3. Check IronWifi logs for details
  4. Verify EAP method configuration

Debug Commands (AireOS)

# Show Hotspot 2.0 configuration
show wlan hotspot

# Show 802.11u configuration
show wlan 1 hotspot dot11u

# Debug Hotspot 2.0
debug hotspot all enable

# Show RADIUS statistics
show radius summary

# Show client details
show client detail MAC_ADDRESS

Debug Commands (Catalyst 9800)

# Show Hotspot 2.0 configuration
show wireless profile hotspot2 detailed IronWifi-Passpoint

# Show ANQP server
show wireless hotspot anqp-server detailed IronWifi-ANQP

# Debug commands
debug wireless hotspot2

# Show client
show wireless client mac-address MAC detail

Best Practices

  1. Use Wave 2 APs: Ensure APs support Hotspot 2.0
  2. Firmware: Keep WLC and APs on supported versions
  3. Testing: Test with multiple device types
  4. Monitoring: Monitor authentication success rates
  5. Redundancy: Configure backup RADIUS servers