From c1eb377808f68d8a63a751db1d319d24930caeaa Mon Sep 17 00:00:00 2001 From: Ranbel Sun Date: Wed, 23 Jul 2025 14:50:58 -0400 Subject: [PATCH 1/6] add new mdm macOS option --- .../warp/deployment/mdm-deployment/index.mdx | 27 ++++++++++++++----- 1 file changed, 21 insertions(+), 6 deletions(-) diff --git a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx index a37fb62f525a2db..f1c94977295d57d 100644 --- a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx +++ b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx @@ -24,7 +24,7 @@ This page provides generic instructions for an automated deployment. If you want ## Windows -The WARP Client for Windows allows for an automated install via tools like Intune, AD, or any script or management tool that can execute a `.msi` file. +The WARP client for Windows allows for an automated install via tools like Intune, AD, or any script or management tool that can execute a `.msi` file. ### Install WARP @@ -89,7 +89,9 @@ The WARP client will now launch WebView2 when the user is registering their devi ## macOS -The Cloudflare WARP macOS client allows for an automated install via tools like Jamf, Intune, Kandji, or JumpCloud or any script or management tool that can place a `com.cloudflare.warp.plist` file in `/Library/Managed Preferences` on a supported macOS device. Additionally this plist can be wrapped in a `.mobileconfig`. +The WARP client for macOS allows for an automated install via tools like Jamf, Intune, Kandji, or JumpCloud or any script or management tool that can place a `com.cloudflare.warp.plist` file in `/Library/Managed Preferences`. The plist can also be wrapped in a `.mobileconfig`. + +If you do not wish to use a management tool, you can manually place an `mdm.xml` file in `/Library/Application Support/Cloudflare`. ### Create `plist` file @@ -99,9 +101,9 @@ The Cloudflare WARP macOS client allows for an automated install via tools like 3. (Optional) If you want to manually place the file in `/Library/Managed Preferences` (rather than use a management tool), convert the `plist` into binary format: -```sh -plutil -convert binary1 com.cloudflare.warp.plist -``` + ```sh + plutil -convert binary1 com.cloudflare.warp.plist + ``` The plist must be pushed by an MDM tool in order to persist after reboot. Manually-placed files will be automatically deleted by the OS. @@ -113,9 +115,22 @@ The plist must be pushed by an MDM tool in order to persist after reboot. Manual 3. Modify the file with your desired [deployment arguments](/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/parameters/). +### Use mdm.xml file + +You can configure [WARP deployment parameters](/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/parameters/) on macOS by manually placing an `mdm.xml` file in `/Library/Application Support/Cloudflare`. This deployment method is an alternative to pushing a `plist` or `mobileconfig` using an MDM tool. + +The format of `/Library/Application Support/Cloudflare/mdm.xml` is as follows: + +```xml + + organization + your-team-name + +``` + ## Linux -The WARP Client for Linux allows for an automated install via the presence of an `mdm.xml` file in `/var/lib/cloudflare-warp`. +The WARP client for Linux allows for an automated install via the presence of an `mdm.xml` file in `/var/lib/cloudflare-warp`. The format of `/var/lib/cloudflare-warp/mdm.xml` is as follows: From 04c90e726e33f51932b1e7f418b7d8ad96f1c699 Mon Sep 17 00:00:00 2001 From: Ranbel Sun Date: Wed, 23 Jul 2025 14:58:39 -0400 Subject: [PATCH 2/6] update switch org examples --- .../mdm-deployment/switch-organizations.mdx | 54 ++----------------- 1 file changed, 5 insertions(+), 49 deletions(-) diff --git a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/switch-organizations.mdx b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/switch-organizations.mdx index a12955354bb4bb3..0006d331801c7e6 100644 --- a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/switch-organizations.mdx +++ b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/switch-organizations.mdx @@ -39,11 +39,9 @@ To enable multiple organizations, administrators need to modify their [MDM file] An MDM file supports a maximum of 25 configurations. The following example includes three configurations. - +### XML - - -```xml +```xml title="mdm.xml" configs @@ -75,56 +73,14 @@ An MDM file supports a maximum of 25 configurations. The following example inclu ``` - - - - -**plist** +### plist -[Download](/cloudflare-one/static/mdm/multiple-orgs/com.cloudflare.warp.plist) an example `.plist` file. If placing the file manually, be sure to [convert the file into binary format](/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/#create-plist-file). +[Download](/cloudflare-one/static/mdm/multiple-orgs/com.cloudflare.warp.plist) an example `.plist` file. -**mobileconfig** +### mobileconfig [Download](/cloudflare-one/static/mdm/multiple-orgs/CloudflareWARP.mobileconfig) an example `.mobileconfig` file. - - - - -```xml - - configs - - - organization - mycompany - display_name - Production environment - - - organization - mycompany - override_api_endpoint - 203.0.113.0 - override_doh_endpoint - 203.0.113.0 - override_warp_endpoint - 203.0.113.0:0 - display_name - China employees - - - organization - test-org - display_name - Test environment - - - -``` - - - ## Switch organizations in WARP From a939128b7177eb7a20d743ddd4354e5f8ee3dfaf Mon Sep 17 00:00:00 2001 From: Ranbel Sun Date: Thu, 24 Jul 2025 12:42:36 -0400 Subject: [PATCH 3/6] apply review suggestions --- .../warp/deployment/mdm-deployment/index.mdx | 16 +++++----------- 1 file changed, 5 insertions(+), 11 deletions(-) diff --git a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx index f1c94977295d57d..69b1d2d8b5e95ec 100644 --- a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx +++ b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx @@ -93,21 +93,15 @@ The WARP client for macOS allows for an automated install via tools like Jamf, I If you do not wish to use a management tool, you can manually place an `mdm.xml` file in `/Library/Application Support/Cloudflare`. -### Create `plist` file +### Prepare file for MDM deployment + +#### `plist` file 1. [Download](/cloudflare-one/static/mdm/com.cloudflare.warp.plist) an example `com.cloudflare.warp.plist` file. 2. Modify the file with your desired [deployment arguments](/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/parameters/). -3. (Optional) If you want to manually place the file in `/Library/Managed Preferences` (rather than use a management tool), convert the `plist` into binary format: - - ```sh - plutil -convert binary1 com.cloudflare.warp.plist - ``` - -The plist must be pushed by an MDM tool in order to persist after reboot. Manually-placed files will be automatically deleted by the OS. - -### Create `mobileconfig` file +#### `mobileconfig` file 1. [Download](/cloudflare-one/static/mdm/CloudflareWARP.mobileconfig) an example `.mobileconfig` file. @@ -115,7 +109,7 @@ The plist must be pushed by an MDM tool in order to persist after reboot. Manual 3. Modify the file with your desired [deployment arguments](/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/parameters/). -### Use mdm.xml file +### Place an unmanaged mdm.xml You can configure [WARP deployment parameters](/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/parameters/) on macOS by manually placing an `mdm.xml` file in `/Library/Application Support/Cloudflare`. This deployment method is an alternative to pushing a `plist` or `mobileconfig` using an MDM tool. From e46a617502b5b2ed30a422f672eaa73032579a63 Mon Sep 17 00:00:00 2001 From: ranbel <101146722+ranbel@users.noreply.github.com> Date: Thu, 24 Jul 2025 15:00:43 -0400 Subject: [PATCH 4/6] Update src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> --- .../connect-devices/warp/deployment/mdm-deployment/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx index 69b1d2d8b5e95ec..3867cb46dbb36ca 100644 --- a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx +++ b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx @@ -99,7 +99,7 @@ If you do not wish to use a management tool, you can manually place an `mdm.xml` 1. [Download](/cloudflare-one/static/mdm/com.cloudflare.warp.plist) an example `com.cloudflare.warp.plist` file. -2. Modify the file with your desired [deployment arguments](/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/parameters/). +2. Modify the file with your desired [deployment parameters](/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/parameters/). #### `mobileconfig` file From 824f15ff32b2cde3b2573875a701a0e303190607 Mon Sep 17 00:00:00 2001 From: ranbel <101146722+ranbel@users.noreply.github.com> Date: Thu, 24 Jul 2025 15:00:51 -0400 Subject: [PATCH 5/6] Update src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> --- .../connect-devices/warp/deployment/mdm-deployment/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx index 3867cb46dbb36ca..3ff72ad3e88714e 100644 --- a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx +++ b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx @@ -107,7 +107,7 @@ If you do not wish to use a management tool, you can manually place an `mdm.xml` 2. Run `uuidgen` from your macOS Terminal. This will generate a value for `PayloadUUID`, which you can use to replace the default value used for `PayloadUUID`. -3. Modify the file with your desired [deployment arguments](/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/parameters/). +3. Modify the file with your desired [deployment parameters](/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/parameters/). ### Place an unmanaged mdm.xml From 946f77d3caca148709d8f1e264a3f05b6433a67b Mon Sep 17 00:00:00 2001 From: ranbel <101146722+ranbel@users.noreply.github.com> Date: Thu, 24 Jul 2025 15:00:58 -0400 Subject: [PATCH 6/6] Update src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> --- .../connect-devices/warp/deployment/mdm-deployment/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx index 3ff72ad3e88714e..5d77fd2b867ba55 100644 --- a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx +++ b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/index.mdx @@ -109,7 +109,7 @@ If you do not wish to use a management tool, you can manually place an `mdm.xml` 3. Modify the file with your desired [deployment parameters](/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/parameters/). -### Place an unmanaged mdm.xml +### Place an unmanaged `mdm.xml` file You can configure [WARP deployment parameters](/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/parameters/) on macOS by manually placing an `mdm.xml` file in `/Library/Application Support/Cloudflare`. This deployment method is an alternative to pushing a `plist` or `mobileconfig` using an MDM tool.