Deployment via Jamf Pro
- Step 1: Download Required Files
- Step 2: Add the Installer Script
- Step 3: Add the Uninstaller Script
- Step 4: Create the Agent Installation Policy
- Step 5: Create the CA Certificate Configuration Profile
- Step 6: Create the DNS Proxy Extension Configuration Profile
- Step 7: Create the Customer-Specific Configuration Profile
- Uninstalling DefensX
This guide covers deploying the DefensX Agent to macOS devices managed by Jamf Pro. The process uses shared scripts applicable to all customers, plus separate configuration profiles for the CA certificate, DNS Proxy extension, and customer-specific deployment settings.
|
Tip
|
Steps 2–6 are customer-agnostic and only need to be set up once. To deploy to a new customer or deployment, only repeat Step 7 with the corresponding mobileconfig file. For new devices under an existing customer, simply update the Scope of the existing policies and profiles. |
Step 1: Download Required Files
Log in to the DefensX backend and navigate to Policies & Groups. Under the Deployments section, locate your deployment and click the RMM button.
In the RMM dialog, click Mac MDM and download the following files:
| File | How to Download |
|---|---|
|
Click Download Installer Script |
|
Click Download DefensX-CA Certificate → As mobileconfig |
|
Click DNS Proxy Extension mobileconfig |
|
Click Download mobileconfig |
|
Click Download Uninstaller Script |
Keep all files available, they are needed in the steps below.
Step 2: Add the Installer Script
-
Log in to your Jamf Pro instance.
-
Navigate to Settings → Computer Management, search for "script", and click Scripts.
-
Click + New in the top right.
-
On the General tab, enter DefensX Install Script as the Display Name.
-
Click the Script tab, open
DefensX-installer.shin a text editor, and paste its contents into the script field.
-
Click Save.
Step 3: Add the Uninstaller Script
Follow the same steps as in Step 2 to add the uninstaller script.
-
On the General tab, enter DefensX Uninstall Script as the Display Name.
-
Click the Script tab, open
DefensX-uninstaller.shin a text editor, and paste its contents into the script field. -
Click Save.
Step 4: Create the Agent Installation Policy
This policy attaches the installer script from Step 2 and deploys it to the target computers.
-
Navigate to Computers → Policies and click + New in the top right.
-
On the General tab, enter DefensX Agent Installation as the Display Name.
-
Select a trigger — Startup, Enrollment Complete, Recurring Check-in, or another trigger appropriate for your environment.
-
Click the Scripts tab on the left, then click Configure.
-
Click Add next to
DefensX Install Script.
-
Click the Scope tab and select the computers where you want to install DefensX.
-
Click Save.
|
Tip
|
It is safe to deploy the DefensX Agent before pushing the mobileconfig profiles. The agent installs and remains inactive until the configuration profile is received. |
The agent will be installed within approximately 15 minutes, based on the default Recurring Check-in interval in Jamf Pro.
Step 5: Create the CA Certificate Configuration Profile
This profile deploys the DefensX Root CA certificate to managed devices.
-
Navigate to Computers → Configuration Profiles and click Upload.
-
Click Choose File and upload
DefensX-CA.mobileconfig. -
Click the Scope tab and select the target computers.
-
Click Save.
Step 6: Create the DNS Proxy Extension Configuration Profile
This profile grants the DefensX DNS Proxy Network Extension the permissions it needs to operate without prompting users for approval. It enables DNS policy enforcement without modifying system-level DNS settings.
-
Navigate to Computers → Configuration Profiles and click Upload.
-
Click Choose File and upload
DefensX-DNSProxy-Extension.mobileconfig. -
Click the Scope tab and select the target computers.
-
Click Save.
Step 7: Create the Customer-Specific Configuration Profile
This profile delivers the unique deployment key and browser settings for a specific customer. Each DefensX deployment has its own mobileconfig file containing the relevant Deployment Key.
-
Navigate to Computers → Configuration Profiles and click Upload.
-
Click Choose File and upload the
DefensX-[deployment].mobileconfigfile downloaded in Step 1. -
Click the Scope tab and select the target computers.
-
Click Save.
Uninstalling DefensX
|
Important
|
Before running the uninstall script, remove the target devices from the installation policy (Step 4) and all three configuration profiles (Steps 5, 6, and 7). If devices remain in those configurations, Jamf Pro will continue reinstalling the agent and reapplying profiles. |
To create the uninstall policy:
-
Navigate to Computers → Policies and click + New in the top right.
-
On the General tab, enter DefensX Agent Uninstall as the Display Name.
-
Select the desired trigger.
-
Click the Scripts tab on the left, then click Configure.
-
Click Add next to
DefensX Uninstall Scriptcreated in Step 3. -
Click the Scope tab and select the computers to uninstall DefensX from.
-
Click Save.
The uninstall script will execute on the next scheduled trigger based on your Jamf Pro configuration.