While installing the Huntress Agent on your macOS is important to the operation of our tools, there are a few additional steps that should be taken to ensure you are able to receive the full feature set available to the macOS. Without these additional features, you may miss out on certain features, like host isolation and potential future feature releases.
To ensure a complete deployment of the Huntress Agent for macOS, please perform the following steps. Be aware of the NOTES for MDM deployment.
Step 1: Installing the Huntress Agent
Install the Huntress Agent for macOS using your preferred method of deployment. If the Huntress agent is already on the endpoint you can skip this step.
Step 2: Installing and Configuring the Huntress System Extension and Network Content Filter
NOTE: If using an MDM to manage your macOS devices, you will first need to upload this mobileconfig file to create policies that will grant the necessary permissions to the Huntress agent and system extension PRIOR to installing the system extension. Failure to do so will result in additional prompts for the end user to run the system extension correctly that may be accidently skipped resulting in incomplete permissions.
Install the System Extension for the Huntress Agent for macOS. This guide will also go over how to approve and install the Network Content Filter, which when used with the system extension allows us to isolate hosts during critical incidents.
Step 3: Granting Full Disk Access to the Huntress Agent and the Huntress System Extension
NOTE: If you used the MDM option above, you do not need to perform these steps below. The mobileconfig file will grant these permissions automatically. This step is only required if you did not use an MDM to upload the mobileconfig file.
Manually grant Full-Disk Access (FDA) to the Huntress Agent and the Huntress System Extension
- Both the "Huntress" service and the "sysext" service" require full disk access to fully function
- Skipping this step will result in a lack of access to some current and future features