|
5 | 5 | order: 3 |
6 | 6 | --- |
7 | 7 |
|
| 8 | +import { Details, Badge } from "~/components"; |
| 9 | + |
8 | 10 | Captive portals are used by public Wi-Fi networks (such as airports, coffee shops, and hotels) to make a user agree to their Terms of Service or provide payment before allowing access to the Internet. When a user connects to the Wi-Fi, the captive portal blocks all HTTPS traffic until the user completes a captive portal login flow in their browser. This prevents the WARP client from connecting to Cloudflare. At the same time, WARP creates [firewall rules](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#ip-traffic) on the device to send all traffic to Cloudflare. The user is therefore unable to access the captive portal login screen unless they temporarily disable WARP. |
9 | 11 |
|
10 | 12 | ## Allow users to connect to captive portals |
@@ -42,3 +44,33 @@ If WARP cannot establish a connection to Cloudflare, it will: |
42 | 44 |
|
43 | 45 | - Captive portals that intercept all DNS traffic will block WARP's [DoH connection](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#overview). Users will likely see a [CF_NO_NETWORK](/cloudflare-one/connections/connect-devices/warp/troubleshooting/client-errors/#cf_no_network) error after they login to the captive portal. |
44 | 46 | - Captive portals that only allow HTTPS traffic will block WARP's [Wireguard UDP connection](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#overview). Users will likely see a [CF_HAPPY_EYEBALLS_MITM_FAILURE](/cloudflare-one/connections/connect-devices/warp/troubleshooting/client-errors/#cf_happy_eyeballs_mitm_failure) error after they login to the captive portal. |
| 47 | + |
| 48 | +## Get captive portal logs <Badge text="Beta" variant="note" /> |
| 49 | + |
| 50 | +<Details header="Feature availability"> |
| 51 | + |
| 52 | +| [WARP modes](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/) | [Zero Trust plans](https://www.cloudflare.com/teams-pricing/) | |
| 53 | +| ----------------------------------------------------------------------------------------- | ------------------------------------------------------------- | |
| 54 | +| All modes | All plans | |
| 55 | + |
| 56 | +| System | Availability | Minimum WARP version | |
| 57 | +| -------- | ------------ | -------------------- | |
| 58 | +| Windows | ✅ | 2025.4.589.1 | |
| 59 | +| macOS | ✅ | 2025.4.589.1 | |
| 60 | +| Linux | ❌ | | |
| 61 | +| iOS | ❌ | | |
| 62 | +| Android | ❌ | | |
| 63 | +| ChromeOS | ❌ | | |
| 64 | + |
| 65 | +</Details> |
| 66 | + |
| 67 | +Captive portal logs are used by Cloudflare Support to troubleshoot WARP captive portal issues. When an end user reports an issue with a captive portal, the IT administrator can ask the user to collect captive portal logs on their device. The administrator can then attach the logs to a Cloudflare Support ticket. |
| 68 | + |
| 69 | +To get captive portal logs: |
| 70 | + |
| 71 | +1. Open the WARP client. |
| 72 | +2. Go to **Settings** (gear icon) > **Preferences** > **Advanced**. |
| 73 | +3. Select **Collect Captive Portal Diag**. |
| 74 | +4. The WARP client will ask if the device is connected (or attempting to connect) to the Wi-Fi network that is causing issues. Select **Yes** to confirm. |
| 75 | + |
| 76 | +Once the diagnostic finishes running, WARP will place a `warp-captive-portal-diag-<date>-<time>.zip` file on the user's desktop. The end user can now share this file with their IT administrator. |
0 commit comments