If you use Jamf for remote management of Apple devices, you can create a Jamf policy for distributed installation of the Mac Host Sensor on managed macOS devices.
For information about TDR Host Sensor OS compatibility, see the Threat Detection & Response Release Notes on the Fireware Release Notes page.
To install a Mac Host Sensor through Jamf, you must have:
- Host Sensor .pkg installer file
- TDR Account ID
- TDR Controller Address
Use this procedure for initial installation of the Mac Host Sensor.
Updates to the Host Sensor occur automatically through TDR.
Download the Host Sensor and Account Information
To download the Mac Host Sensor .pkg installation file and get the required account information:
- Log In to the TDR Web UI.
- Select Configuration > Host Sensor.
Download instructions and links appear for each Host Sensor.
- Copy the Account ID and Controller Address.
- In the Mac section, click Download.
The Host Sensor .pkg installer file downloads.
The installer file name is host_sensor_<version>.pkg.
Configure Jamf to Install the Mac Host Sensor
To use Jamf to install the Mac Host Sensor, you must:
- Upload the Host Sensor.pkg file to Jamf
- Add a Jamf policy to install the package
For detailed instructions about how to create packages and policies in Jamf, see the Jamf documentation.
To upload the .pkg file to a Jamf package:
- Log in to your Jamf management interface.
- Create a new Jamf package.
The New Package page appears.
- Click Choose file. Find and double-click the Host Sensor .pkg file you downloaded from TDR.
- In the Display Name text box type a package name. For example, TDR Host Sensor.
- From the Category drop-down list, select a package category defined in your Jamf instance.
- In the Info text box, type any other information to identify this package. For example, type the TDR Host Sensor version.
- Save the package.
To create the policy to install the package:
- Add a new Jamf policy.
- In the Display Name text box, specify a name for the policy.
- In the Trigger section, select conditions that trigger the installation. Recommended triggers include:
- Enrollment Complete — Install the Host Sensor on newly enrolled computers
- Recurring Check-in — Install the Host Sensor on previously enrolled computers
- From the Execution Frequency drop-down list, select Once per computer.
- Click Packages.
- Select the TDR Host Sensor package you added earlier
- From the Action drop-down list, select Install.
- Click Files and Processes.
- In the Execute Command text box, type this command, without spaces (replace the TDR Account ID and TDR Controller Address with the settings from the Host Sensor configuration page in your TDR account):
/usr/local/watchguard/tdr/configure_hostsensor.sh --account <TDR-Account-ID> --controller <TDR-controller-address>
/usr/local/watchguard/tdr/configure_hostsensor.sh --account 12345678-1234-1234-1234-123456789012 --controller tdr-hsc-na.watchguard.com:443
- In the policy settings, select the Scope tab.
- From the Target Computers drop-down list, select the target computers to deploy this policy to. Select All Computers to install the Host Sensor on all enrolled computers.
- Click Save.
When a new computer is enrolled, or when a previously enrolled computer checks in, Jamf executes the policy once for each computer specified in the scope.
Monitor Host Sensor Status
The first time each installed Host Sensor sends a heartbeat to your Threat Detection and Response account, the host is added to your TDR account and appears in the Hosts list in the TDR Web UI.
To see the status of installed hosts.
- Log In to the TDR Web UI .
- Select Devices > Hosts.
The icon in the Sensor Status column indicates the status of the Host Sensor on each computer.
- — Host Sensor is installed and operational
- — Host Sensor is installed but has a problem
- — Host Sensor is not communicating
- — Host Sensor has shut down correctly
- — Host Sensor has protection paused
- — Host Sensor has contained the host
For more information about the Hosts page, see Manage TDR Hosts and Host Sensors.