Skip to content

Commit 0a0d33c

Browse files
[ZT] Captive portal diag button (#21800)
* captive portal diag button * wording change * remove admin line * clarify wording * admin vs end user actions * Update src/content/docs/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-settings/captive-portals.mdx Co-authored-by: Kate Tungusova <[email protected]> * lowercase desktop * beta pill * Apply suggestions from code review --------- Co-authored-by: Kate Tungusova <[email protected]>
1 parent ee2d509 commit 0a0d33c

File tree

2 files changed

+34
-2
lines changed

2 files changed

+34
-2
lines changed

src/content/docs/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-settings/captive-portals.mdx

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ sidebar:
55
order: 3
66
---
77

8+
import { Details, Badge } from "~/components";
9+
810
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.
911

1012
## Allow users to connect to captive portals
@@ -42,3 +44,33 @@ If WARP cannot establish a connection to Cloudflare, it will:
4244

4345
- 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.
4446
- 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.

src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/warp-logs.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ To view WARP logs on desktop devices:
2424
warp-diag
2525
```
2626

27-
This will place a `warp-debugging-info-<date>-<time>.zip` on your Desktop.
27+
This will place a `warp-debugging-info-<date>-<time>.zip` on your desktop.
2828

2929
</TabItem> <TabItem label="Windows">
3030

@@ -34,7 +34,7 @@ This will place a `warp-debugging-info-<date>-<time>.zip` on your Desktop.
3434
C:\Users\JohnDoe>warp-diag
3535
```
3636

37-
This will place a `warp-debugging-info-<date>-<time>.zip` on your Desktop.
37+
This will place a `warp-debugging-info-<date>-<time>.zip` on your desktop.
3838

3939
</TabItem> <TabItem label="Linux">
4040

0 commit comments

Comments
 (0)