Skip to content

Commit 8908523

Browse files
[CF1] override code troubleshooting
1 parent bf70e4d commit 8908523

File tree

2 files changed

+34
-5
lines changed

2 files changed

+34
-5
lines changed

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

Lines changed: 30 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -27,13 +27,31 @@ WARP settings define the WARP client modes and permissions available to end user
2727

2828
:::note
2929

30-
In order to enable **Admin override**, [**Lock WARP switch**](#lock-warp-switch) must also be enabled.
30+
To enable **Admin override**, you must have first enabled the [**Lock WARP switch**](#lock-warp-switch).
3131

3232
:::
3333

34-
When `Enabled`, end users can turn off the WARP client using an override code provided by an admin. This feature allows users to work around a temporary network issue (for example, an incompatible public Wi-Fi, or a firewall at a customer site blocking the connection).
34+
When **Admin override** is turned on, end users can turn off the WARP client using an override code provided by an admin.
3535

36-
You can set a **Timeout** to define how long a user can toggle on or off the WARP switch. The timer starts when the user first enters their code into the WARP client. The code remains valid and can be reused anytime during this time period. For example, if **Timeout** is 24 hours, the user can re-enter the code at 23:59:00 and continue to turn off WARP until 47:59:00 (up to 48 hours total).
36+
To enable **Admin override**:
37+
38+
1. In [Zero Trust](https://one.dash.cloudflare.com/), go to **Settings** > **WARP Client**.
39+
2. Toggle **Admin override** on.
40+
3. (Optional) Set the **Timeout** to your desired time. **Timeout** is set to 1 hour by default.
41+
42+
**Admin override** allows end users to momentarily turn off WARP with an override code to work around a temporary network issue (for example, an incompatible public Wi-Fi, or a firewall at a customer site blocking the connection).
43+
44+
As admin, you can set a **Timeout** to define how long a user can toggle on or off the WARP switch after entering the override code. Cloudflare generates a new override code every hour that the admin can access and send to end users. The override code's validity adheres to fixed-hour time blocks and aims to be generous to the end user. For example, if admin generates a code with a **Timeout** of one hour at 9:00 AM and the end user inputs the override code in their device at 9:59AM, the user will be able to toggle WARP on and off until 10:59AM (a one hour duration.)
45+
46+
However, if admin generates an override code at 9:00 AM that has a one hour Timeout and the user attempts to enter it at 10:00 AM, the override code will not work.
47+
48+
If an admin generated an override code at 9:00 AM and set a **Timeout** to three hours, a user who enters the override code at 9:59 AM would be able to toggle WARP off for three hours (until 12:59 PM). A user who enters the same override code at 10AM would only be able to toggle WARP off for two hours (until 12 PM) because the 9:00 AM hour block would be counted as used.
49+
50+
To learn more about override code timeouts and how Cloudflare calculates an override code's validity, refer to Troubleshooting.
51+
52+
:::
53+
54+
Be aware that if [**Auto connect**](#auto-connect) is enabled, WARP will turn on according to the value set by **Auto connect** even when an override code has been entered by the user. To prevent WARP from auto connecting, temporarily disable **Auto connect** or temporarily set a longer **Timeout** for **Auto connect**.
3755

3856
#### Retrieve the override code
3957

@@ -163,10 +181,17 @@ For more details on WireGuard versus MASQUE, refer to our [blog post](https://bl
163181

164182
Allows the user to turn off the WARP switch and disconnect the client.
165183

184+
To enable the Lock WARP switch:
185+
186+
1. In [Zero Trust](https://one.dash.cloudflare.com/), go to **Settings** > **WARP Client**.
187+
2. Find the profile you would like to enable the Lock WARP switch for and select the three dot icon next to the profile.
188+
3. Select **Configure**.
189+
4. Under **Configure settings**, toggle the **Lock WARP switch** on.
190+
166191
**Value:**
167192

168-
- `Disabled`: (default) The user is able to turn the switch on or off at their discretion. When the switch is off, the user will not have the ability to reach sites protected by Access that leverage certain device posture checks.
169-
- `Enabled`: The user is prevented from turning off the switch. The WARP client will always start in the connected state.
193+
- `Disabled`: (default) The user is able to turn the WARP switch on or off at their discretion. When the WARP switch is off, the user will not have the ability to reach sites protected by Access that leverage certain device posture checks.
194+
- `Enabled`: The user is prevented from turning off the WARP switch. The WARP client will always start in the connected state.
170195

171196
On MDM deployments, you must also include the `auto_connect` parameter with at least a value of `0`. This will prevent clients from being deployed in the off state without a way for users to manually enable them.
172197

src/content/docs/cloudflare-one/faq/troubleshooting.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -267,3 +267,7 @@ Turning off TLS decryption should be a temporary measure. TLS decryption should
267267
## I am getting an `Error 401: deleted_client - The OAuth Client was deleted` authorization error.
268268

269269
<Render file="access/error-401" product="cloudflare-one" />
270+
271+
## I entered an override code for WARP that was supposed to be valid for 3 hours but the override code expired faster than I expected.
272+
273+
## I disabled WARP using an override code but WARP turned on by itself before my override code expired.

0 commit comments

Comments
 (0)