Skip to content

Commit 4df3197

Browse files
committed
global warp override
1 parent fbda855 commit 4df3197

File tree

1 file changed

+13
-12
lines changed
  • src/content/docs/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-settings

1 file changed

+13
-12
lines changed

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

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -26,14 +26,14 @@ WARP settings define the WARP client modes and permissions available to end user
2626
<Render file="warp/all-systems-modes-plans" />
2727

2828
:::note
29-
30-
To use **Admin override**, you must first have enabled the [**Lock WARP switch**](#lock-warp-switch). **Admin override** is only needed and used when the WARP lock switch is turned on.
31-
29+
To use **Admin override**, you must first have enabled [**Lock WARP switch**](#lock-warp-switch).
3230
:::
3331

34-
When the [**Lock WARP switch**](#lock-warp-switch) is enabled, users cannot toggle the WARP client on and off on their device. Enabling **Admin override** gives users the ability to temporarily turn off the WARP client using an override code provided by an admin. **Admin override** is only needed in a configuration where the **lock WARP switch** is enabled.
32+
When [**Lock WARP switch**](#lock-warp-switch) is enabled, users cannot toggle the WARP client on and off on their device. Enabling **Admin override** gives users the ability to temporarily turn on or off the WARP client using an override code provided by an admin. **Admin override** is only needed in a configuration where **Lock WARP switch** is enabled.
3533

36-
**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).
34+
Example use cases for **Admin override** include:
35+
- Allowing users to momentarily turn off WARP to work around a temporary network issue such as an incompatible public Wi-Fi, or a firewall at a customer site blocking the connection.
36+
- Allowing test users to turn on WARP when [Global WARP override](#global-warp-override) is in effect.
3737

3838
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.
3939

@@ -53,20 +53,19 @@ To retrieve the one-time code for a user:
5353
2. Go to **My Team** > **Devices**.
5454
3. Select **View** for a connected device.
5555
4. Scroll down to **User details** and copy the 7-digit **Override code**.
56-
5. Share this code with the end user for them to enter on their device.
56+
5. Share this code with the user for them to enter on their device.
5757

5858
The user will have an unlimited amount of time to activate their code.
5959

6060
#### Enter the override code
6161

62-
To turn off the WARP client on a user device:
62+
To activate the override code on a user device:
6363

6464
1. In the WARP client, go to **Settings** > **Preferences** > **Advanced**.
6565
2. Select **Enter code**.
6666
3. Enter the override code. The WARP client will display a pop-up window showing when the override expires.
67-
4. Turn off the WARP switch.
6867

69-
The client will automatically reconnect after the [Auto connect period](#auto-connect), but the user can continue to turn off WARP until the override expires.
68+
The user can now toggle the WARP switch or use the `warp-cli connect` command. The client will automatically reconnect after the [Auto connect period](#auto-connect), but the user can continue to turn on or off WARP until the override expires.
7069

7170
### Install CA to system certificate store
7271

@@ -134,11 +133,13 @@ The CGNAT IP assigned to a WARP device is permanent until the device unregisters
134133
Requires the [Super Administrator](/cloudflare-one/roles-permissions/) role.
135134
:::
136135

137-
When you turn on **Global WARP override**, Cloudflare will immediately disconnect all WARP clients that are currently connected to your Zero Trust organization. This allows WARP to fail open in case of an incident or outage. [Auto connect](#auto-connect) will not apply while the override is on. Users will receive a notification on their device, and the WARP client will display `Error code: GLOBAL_WARP_OVERRIDE`.
136+
**Global WARP override** allows administrators to fail open WARP in case of an incident or outage. When you turn on **Global WARP override**, Cloudflare will immediately disconnect all WARP clients that are connected to your Zero Trust organization. End users will receive a notification on their device and the WARP client will display `The administrator for your account has disconnected WARP`.
137+
138+
All clients including end user devices, [WARP Connector](/cloudflare-one/connections/connect-networks/private-net/warp-connector/) hosts, and [WARP-to-WARP](/cloudflare-one/connections/connect-networks/private-net/warp-to-warp/) devices will be unable to connect until you turn off **Global WARP override**. [Auto connect](#auto-connect) settings and any active [Admin override](#admin-override) codes will not apply while the override is on.
138139

139-
If [Lock WARP switch](#lock-warp-switch) is `Disabled`, the user will be able to manually reconnect using the WARP GUI or the `warp-cli connect` command. This allows test users to come back online as needed to test resolution of the incident that led to the global disconnect. It also allows users who may not be impacted by the incident to resume normal operations.
140+
You can provide users with a new [Admin override](#admin-override) code to manually reconnect as needed during the override. For example, you may want IT staff to test resolution of the incident that led to the global disconnect.
140141

141-
To immediately reconnect all WARP clients, turn off **Global WARP override**.
142+
To resume normal operations, turn off **Global WARP override**. If you configured an [Auto connect](#auto-connect) value, the WARP client will automatically reconnect. Otherwise, WARP will remain disconnected until the user manually reconnects.
142143

143144
## Device settings
144145

0 commit comments

Comments
 (0)