Cisco Catalyst 9800 Series Wireless Controller Software Configuration Guide, Cisco IOS XE 26.1.x

PDF

Cisco Catalyst 9800 Series Wireless Controller Software Configuration Guide, Cisco IOS XE 26.1.x

Captive bypassing

Want to summarize with AI?

Log in

Configuring Captive Bypassing for WLAN in LWA and CWA (GUI), Configuring Captive Bypassing for WLAN in LWA and CWA


A captive bypass is a network behavior that

  • enables client devices to automatically determine Internet connectivity and initiate authentication flows,

  • may enable users to bypass captive portal splash pages through protocols such as WISPr.

  • involves interaction between devices (such as Apple iOS) and Controllers, affecting web redirection and authentication.

Additional reference information

WISPr is a draft protocol that enables users to roam between different wireless service providers. Devices like Apple iOS use HTTP WISPr requests to check if they are connected to the Internet.

When direct Internet connectivity is not detected, these mechanisms prompt the device to open a web browser so the user can enter credentials for Internet access. Authentication occurs in the background whenever the device connects to a new SSID.

When an Apple iOS device connects, it sends a WISPr request to the Controller, which checks the user agent details and then triggers an HTTP request with web authentication interception. After verifying the iOS version and browser details, the Controller allows the client device to bypass captive portal settings and access the Internet.

This HTTP request triggers web authentication interception on the Controller just as any other page requests do. This leads to the standard web authentication process. If web authentication uses splash page features (such as a URL from a configured RADIUS server), the splash page might not appear for the user because WISPr requests occur at short intervals. Once a query reaches the server, web redirection or splash page display running in the background is cancelled, and the device processes the page request, which may prevent the splash page from being displayed as intended.

Example

For instance, Apple introduced an iOS feature that detects captive portals by sending a web request upon connecting to a wireless network. On iOS 6 and earlier, the request is sent to http://www.apple.com/library/test/success.html. On iOS 7 and later, multiple possible URLs are used. If a response is received, Internet access is assumed and no further interaction occurs. If no response is received, Internet access is assumed to be blocked and the device’s Captive Network Assistant (CNA) auto-launches a pseudo-browser to prompt for portal login. The CNA may not function properly if it is redirected to an ISE captive portal. The Controller can suppress the pop-up of the pseudo-browser. Network administrators can configure the Controller to bypass WISPr detection. In this configuration, web authentication interception only occurs when a user intentionally requests a web page, ensuring the splash page is loaded in the user's browser context and not triggered by background connectivity probes.

Analogy: Sneaking into an amusement park

Captive bypassing is like someone sneaking into an amusement park through a side door, instead of showing their ticket at the main entrance. Some devices use automated checks to find shortcuts and access the internet without going through the intended login page, just as clever visitors might bypass security by finding an easier way in. Network controls are needed to make sure everyone enters through the main gate and checks in properly.


Configure captive bypassing for WLAN in LWA and CWA (GUI)

Enable client devices to bypass captive portal authentication on the selected WLAN.

Before you begin

Use this task when you need certain clients to connect without passing through the captive portal, typically for pre-authorized devices.
Ensure you have administrative access to the device and the parameter map is appropriately configured.

Procedure

1.

Choose Configuration > Security > Web Auth .

2.

In the Webauth Parameter Map tab, click the parameter map name. The Edit WebAuth Parameter window is displayed.

3.

Select Captive Bypass Portal check box.

4.

Click Update & Apply to Device .

The selected WLAN now allows captive bypass in accordance with your configuration.

Configure captive bypassing for WLAN in LWA and CWA

Enable captive bypassing for WLAN to allow users to bypass the captive portal.
This configuration is applicable in environments where users need to access the network without going through a captive portal.

Procedure

1.

Enter global configuration mode.

Example:

Device# configure terminal
2.

Create the parameter map.

Example:

Device(config)# parameter-map type webauth parameter-map-name

The parameter-map-name must not exceed 99 characters.

3.

Configure captive bypassing.

Example:

Device(config)# captive-bypass-portal
4.

Specify the WLAN name and ID.

Example:

Device(config)# wlan profile-name wlan-id ssid-name
  • profile-name is the WLAN name which can contain 32 alphanumeric characters.

  • wlan-id is the wireless LAN identifier. The valid range is from 1 to 512.

  • ssid-name is the SSID which can contain 32 alphanumeric characters.

5.

Enable the web authentication for the WLAN.

Example:

Device(config-wlan)# security web-auth
6.

Map the parameter map.

Example:

Device(config-wlan)# security web-auth parameter-map parameter-map-name

If the parameter map is not associated with a WLAN, the configuration is considered from the global parameter map.

7.

(Optional) Return to privileged EXEC mode.

Example:

Device(config-wlan)# end

Alternatively, you can also press Ctrl-Z to exit global configuration mode.

The WLAN is now configured with captive bypassing enabled, allowing users to bypass the captive portal.