Skip to content

Commit b536cd5

Browse files
edits to scenarios
1 parent 8908523 commit b536cd5

File tree

2 files changed

+32
-21
lines changed

2 files changed

+32
-21
lines changed

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

Lines changed: 6 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -27,32 +27,24 @@ WARP settings define the WARP client modes and permissions available to end user
2727

2828
:::note
2929

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

3232
:::
3333

34-
When **Admin override** is turned on, end users can turn off the WARP client using an override code provided by an admin.
35-
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.
34+
When the [**Lock WARP switch**](#lock-warp-switch) is enabled, users cannot turn the WARP client off on their device. Enabling **Admin override** gives users the ability to turn off the WARP client using an override code provided by an admin.
4135

4236
**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).
4337

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.)
38+
As admin, you can set a **Timeout** to define how long a user can toggle the WARP switch on or off after entering the override code. Cloudflare generates a new override code every hour that an admin can send to end users. The override code's validity adheres to fixed-hour time blocks and aims to be generous to the end user.
4539

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.
40+
:::caution[Troubleshooting]
4741

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.
42+
To learn more about override code timeouts and how Cloudflare calculates an override code's valid duration, refer to [Troubleshooting](/cloudflare-one/faq/troubleshooting/#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).
4943

50-
To learn more about override code timeouts and how Cloudflare calculates an override code's validity, refer to Troubleshooting.
44+
If [**Auto connect**](#auto-connect) is enabled, WARP will turn on even when using a **Admin override**. Refer to [Troubleshooting](/cloudflare-one/faq/troubleshooting/#i-disabled-warp-using-an-override-code-but-warp-turned-on-by-itself-before-my-override-code-expired) for more details.
5145

5246
:::
5347

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**.
55-
5648
#### Retrieve the override code
5749

5850
To retrieve the one-time code for a user:
@@ -181,13 +173,6 @@ For more details on WireGuard versus MASQUE, refer to our [blog post](https://bl
181173

182174
Allows the user to turn off the WARP switch and disconnect the client.
183175

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-
191176
**Value:**
192177

193178
- `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.

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

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -270,4 +270,30 @@ Turning off TLS decryption should be a temporary measure. TLS decryption should
270270

271271
## 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.
272272

273+
[Admin override](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-settings/#admin-override) codes are time-sensitive and adhere to fixed-hour time blocks. An override code's validity is attached to the hour it was generated in. Override codes cannot be reused after their timeout has expired. When an override code timeout has expired, the user must receive a new override code from the admin. Refer to the following scenarios.
274+
275+
### Scenario one: Admin generates an override code at 9:00 AM with a timeout of one hour.
276+
277+
If admin generates an override code with a timeout of one hour at **9:00 AM** and the user inputs the override code in their device at **9:59 AM**, the user will be able to toggle WARP on and off until **10:59 AM** (a one hour duration.)
278+
279+
However, if the user attempts to enter the override code at **10:00 AM**, the override code will not work. The override code will not work because the override code was generated at **9:00 AM** and its one hour validity was counted as used in the 9:00 AM to 10:00 AM hour.
280+
281+
### Scenario two: Admin generates an override code at 9:30 AM with timeout of three hours.
282+
283+
If admin generates an override code with a timeout of three hours at **9:30 AM** and the user inputs the override code in their device at **9:59 AM**, the user will be able to toggle WARP on and off until **12:59 PM** (a three hour duration.)
284+
285+
However, if the user attempts to enter the override code at **10:00 AM**, the override code will only be valid until **12:00 PM** (a two hour duration). The override code was generated at **9:30 AM** and one hour of its total three hour validity was counted as used in the 9:00 AM to 10:00 AM hour.
286+
287+
### Scenariot three: Admin generates an override code at 12:30 PM with a timeout of 24 hours.
288+
289+
If admin generates an override code with a timeout of 24 hours at **12:00 PM** and the user inputs the override code in their device at **12:59 PM** the same day, the user will be able to toggle WARP on and off until **12:59 PM** the next day (a 24 hour duration.)
290+
291+
However, if the user attempts to enter the override code at **1:00 PM** the same day, the override code will only be valid until **11:00 AM** the next day (a 23 hour duration). The override code was generated at **12:00 PM** and one hour of its total 24 hour validity was counted as used in the 12:00 PM to 1:00 PM hour.
292+
293+
If the user attempts to enter the override code at **12:59 PM** the next day, the override code will only be valid until **1:59 PM** (a one hour duration). The override code was generated at **12:00 PM** and 23 hours of its total 24 hour validity were counted as used from 12:00 PM to 11:00 AM the next day (a 23 hour duration).
294+
273295
## I disabled WARP using an override code but WARP turned on by itself before my override code expired.
296+
297+
If you are using an [Admin override](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-settings/#admin-override) code with [Auto connect](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-settings/#auto-connect) enabled, WARP will turn on automatically according to the Timeout set for **Auto connect** even when an override code has been entered by the user.
298+
299+
To prevent WARP from auto connecting while using an admin override code, temporarily disable **Auto connect** or temporarily set a longer **Timeout** for **Auto connect**.

0 commit comments

Comments
 (0)