Skip to content

Commit e30fefa

Browse files
authored
[ZT] Add cert to MDMs (#18003)
1 parent c4835aa commit e30fefa

File tree

1 file changed

+102
-20
lines changed
  • src/content/docs/cloudflare-one/connections/connect-devices/warp/user-side-certificates

1 file changed

+102
-20
lines changed

src/content/docs/cloudflare-one/connections/connect-devices/warp/user-side-certificates/manual-deployment.mdx

Lines changed: 102 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -73,6 +73,34 @@ openssl x509 -noout -fingerprint -sha256 -inform pem -in <certificate.pem>
7373
sha256 Fingerprint=F5:E1:56:C4:89:78:77:AD:79:3A:1E:83:FA:77:83:F1:9C:B0:C6:1B:58:2C:2F:50:11:B3:37:72:7C:62:3D:EF
7474
```
7575

76+
### Convert the certificate
77+
78+
Some applications require a certificate formatted in the `.cer` file type. You can convert your downloaded certificate using [OpenSSL](https://www.openssl.org/):
79+
80+
<Tabs>
81+
<TabItem label="macOS and Linux" icon="seti:shell">
82+
83+
1. [Install OpenSSL](https://wiki.openssl.org/index.php/Compilation_and_Installation).
84+
2. [Download a Cloudflare certificate](#download-the-cloudflare-root-certificate) in `.pem` format.
85+
3. In a terminal, convert the certificate to DER format with the `.cer` file type:
86+
```sh
87+
openssl x509 -inform PEM -in ~/Downloads/certificate.pem -outform DER -out ~/Downloads/certificate.cer
88+
```
89+
90+
</TabItem>
91+
92+
<TabItem label="Windows" icon="seti:windows">
93+
94+
1. [Install OpenSSL for Windows](https://slproweb.com/products/Win32OpenSSL.html).
95+
2. [Download a Cloudflare certificate](#download-the-cloudflare-root-certificate) in `.pem` format.
96+
3. In a PowerShell terminal, convert the certificate to DER format with the `.cer` file type:
97+
```powershell
98+
openssl x509 -inform PEM -in "$HOME\Downloads\certificate.pem" -outform DER -out "$HOME\Downloads\certificate.cer"
99+
```
100+
101+
</TabItem>
102+
</Tabs>
103+
76104
## Add the certificate to operating systems
77105

78106
### macOS
@@ -88,7 +116,6 @@ In macOS, you can choose the keychain in which you want to install the certifica
88116
To install a Cloudflare certificate in macOS, you can use either the Keychain Access application or a terminal. Both methods require you to [download a certificate](#download-the-cloudflare-root-certificate) in `.crt` format.
89117

90118
<Tabs>
91-
92119
<TabItem label="Keychain Access">
93120

94121
1. Download a Cloudflare certificate.
@@ -122,7 +149,6 @@ echo | sudo tee -a /etc/ssl/cert.pem < certificate.pem
122149
The root certificate is now installed and ready to be used.
123150

124151
</TabItem>
125-
126152
</Tabs>
127153

128154
:::note[Change certificate access scope]
@@ -303,6 +329,56 @@ To install a Cloudflare certificate to Firefox manually:
303329

304330
For information on installing a Cloudflare certificate for organizations, refer to this [Mozilla support article](https://support.mozilla.org/en-US/kb/setting-certificate-authorities-firefox).
305331

332+
### Mobile device management (MDM) software
333+
334+
Zero Trust integrates with several [mobile device management (MDM) software partners](/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/partners/) to deploy WARP across devices.
335+
336+
#### Microsoft Intune
337+
338+
To upload and deploy a Cloudflare certificate in Microsoft Intune:
339+
340+
1. [Download and convert a Cloudflare certificate](#convert-the-certificate) to DER format with the `.cer` file type.
341+
2. In Microsoft Intune, [create a trusted certificate profile](https://learn.microsoft.com/mem/intune/protect/certificates-trusted-root#to-create-a-trusted-certificate-profile) with your converted certificate.
342+
343+
For more information, refer to the [Microsoft documentation](https://learn.microsoft.com/mem/intune/protect/certificates-trusted-root).
344+
345+
#### Jamf Pro
346+
347+
To upload and deploy a Cloudflare certificate in Jamf Pro:
348+
349+
1. [Download and convert a Cloudflare certificate](#convert-the-certificate) to DER format with the `.cer` file type.
350+
2. In Jamf Pro, go to **Computers** > **Configuration Profiles** to create a computer configuration profile, or go to **Devices** > **Configuration Profiles** to create a mobile device configuration profile. Select **New**.
351+
3. Add a name and description for the profile.
352+
4. Choose whether you would like Jamf to install the certificate automatically or with self-service, and whether you would like to install the certificate for a single user or all users on the device.
353+
5. Select **Add** > **Certificate**. Choose the certificate file.
354+
6. Uncheck **Allow export from keychain**.
355+
7. Select **Scope**, then choose which devices or groups to deploy the certificate to.
356+
8. Select **Save**.
357+
358+
For more information, refer to the [Jamf Pro documentation](https://learn.jamf.com/bundle/jamf-pro-documentation-current/page/PKI_Certificates.html).
359+
360+
#### Kandji
361+
362+
To upload and deploy a Cloudflare certificate in Kandji:
363+
364+
1. [Download a Cloudflare certificate](#download-the-cloudflare-root-certificate) in `.crt` format.
365+
2. In Kandji, [upload the certificate](https://support.kandji.io/support/solutions/articles/72000558739-certificate-profile) as a PKCS #1-formatted certificate.
366+
367+
#### Hexnode
368+
369+
To upload and deploy a Cloudflare certificate in Hexnode:
370+
371+
1. [Download a Cloudflare certificate](#download-the-cloudflare-root-certificate) in `.pem` format.
372+
2. In Hexnode, follow the directions for adding the certificate to [macOS](https://www.hexnode.com/mobile-device-management/help/how-to-add-certificates-for-mac-devices-with-hexnode-mdm/), [iOS](https://www.hexnode.com/mobile-device-management/help/add-certificates-for-ios-devices-with-hexnode-mdm/), and/or [Android](https://www.hexnode.com/mobile-device-management/help/how-to-add-certificates-for-android-devices-using-hexnode-mdm/) devices.
373+
374+
#### JumpCloud
375+
376+
To upload and deploy a Cloudflare certificate in JumpCloud:
377+
378+
1. [Download a Cloudflare certificate](#download-the-cloudflare-root-certificate) in `.pem` format.
379+
2. In JumpCloud, [upload the certificate](https://jumpcloud.com/support/manage-device-trust-certificates#distributing-global-device-certificates-).
380+
3. [Configure a conditional access policy](https://jumpcloud.com/support/configure-a-conditional-access-policy) to deploy the certificate across devices.
381+
306382
### Python
307383

308384
Depending on which version of Python you have installed and your configuration, you may need to use either the `python` or `python3` command. If you use [virtual environments](https://docs.python.org/3/library/venv.html), you will need to repeat the following steps within each virtual environment.
@@ -451,7 +527,8 @@ If you use Kaniko with Google Cloud SDK, you must install a Cloudflare certifica
451527

452528
To trust a Cloudflare root certificate in the Google Drive desktop application, follow the procedure for your operating system. These steps require you to [download the .pem certificate](#download-the-cloudflare-root-certificate).
453529

454-
<Details header="macOS">
530+
<Tabs>
531+
<TabItem label="macOS" icon="apple">
455532

456533
1. In the Finder menu bar, go to **Go** > **Go to Folder**. Enter `/Applications/Google Drive.app/Contents/Resources`.
457534

@@ -475,9 +552,9 @@ You can verify the update with the following command.
475552
defaults read /Library/Preferences/com.google.drivefs.settings
476553
```
477554

478-
</Details>
555+
</TabItem>
479556

480-
<Details header="Windows">
557+
<TabItem label="Windows" icon="seti:windows">
481558

482559
1. In File Explorer, go to `\Program Files\Google\Drive File Stream\<version>\config\`.
483560

@@ -501,7 +578,8 @@ You can verify the update with the following command.
501578
reg QUERY "HKEY_LOCAL_MACHINE\Software\Google\DriveFS" /v TrustedRootCertsFile"
502579
```
503580

504-
</Details>
581+
</TabItem>
582+
</Tabs>
505583

506584
For more information, refer to the [Google documentation](https://support.google.com/a/answer/7644837) for the `TrustedRootCertsFile` setting.
507585

@@ -559,7 +637,8 @@ To install a Cloudflare root certificate on Eclipse IDE for Java Developers, you
559637

560638
3. Add the Cloudflare certificate to Eclipse's JVM:
561639

562-
<Details header="macOS and Linux">
640+
<Tabs>
641+
<TabItem label="macOS and Linux" icon="seti:shell">
563642

564643
1. In a terminal, add the `java.home` value you copied as an environment variable.
565644

@@ -575,33 +654,35 @@ To install a Cloudflare root certificate on Eclipse IDE for Java Developers, you
575654

576655
3. Restart Eclipse.
577656

578-
</Details>
657+
</TabItem>
579658

580-
<Details header="Windows">
659+
<TabItem label="Windows" icon="seti:windows">
581660

582661
1. In a terminal, add the `java.home` value you copied as an environment variable.
583662

584-
```powershell
585-
set JAVA_HOME="\path\to\java.home"
586-
```
663+
```powershell
664+
set JAVA_HOME="\path\to\java.home"
665+
```
587666

588667
2. Run `keytool` to install and trust the Cloudflare certificate.
589668

590-
```powershell
591-
"%JAVA_HOME%\bin\keytool.exe" -import -file "%UserProfile%\Downloads\certificate.crt" -alias CloudflareRootCA -keystore "%JAVA_HOME%\lib\security\cacerts" -storepass changeit -trustcacerts -noprompt
592-
```
669+
```powershell
670+
"%JAVA_HOME%\bin\keytool.exe" -import -file "%UserProfile%\Downloads\Cloudflare_CA.crt" -alias CloudflareRootCA -keystore "%JAVA_HOME%\lib\security\cacerts" -storepass changeit -trustcacerts -noprompt
671+
```
593672

594673
3. Restart Eclipse.
595674

596-
</Details>
675+
</TabItem>
676+
</Tabs>
597677

598678
For more information on adding certificates to Eclipse with `keytool`, refer to [IBM's documentation](https://www.ibm.com/docs/en/ram/7.5.4?topic=client-adding-server-public-certificate-eclipse).
599679

600680
### RubyGems
601681

602682
To trust a Cloudflare root certificate in RubyGems, follow the procedure for your operating system. These steps require you to [download a `.pem` certificate](#download-the-cloudflare-root-certificate).
603683

604-
<Details header="macOS and Linux">
684+
<Tabs>
685+
<TabItem label="macOS and Linux" icon="seti:shell">
605686

606687
1. Install [OpenSSL](https://www.openssl.org/).
607688

@@ -637,9 +718,9 @@ To trust a Cloudflare root certificate in RubyGems, follow the procedure for you
637718
638719
6. Restart any terminal sessions.
639720
640-
</Details>
721+
</TabItem>
641722
642-
<Details header="Windows">
723+
<TabItem label="Windows" icon="seti:windows">
643724
644725
1. Install [OpenSSL for Windows](https://slproweb.com/products/Win32OpenSSL.html).
645726
@@ -675,7 +756,8 @@ To trust a Cloudflare root certificate in RubyGems, follow the procedure for you
675756
676757
6. Restart any terminal sessions.
677758
678-
</Details>
759+
</TabItem>
760+
</Tabs>
679761
680762
### Minikube
681763

0 commit comments

Comments
 (0)