Mac Agent Deployment via Kaseya

Team: Huntress EDR
Product: Kaseya (Script)
Environment: MacOS 
Summary:Huntress agent deployment via Kaseya (Script) RMM

Installing any product should be a breeze and that's especially true with Huntress. We've created a deployment procedure for Kaseya VSA that will install the Huntress agent on macOS (10.15+) without any user interruptions or reboots.

The procedure will automatically use Kaseya's GroupName (vAgentConfiguration.groupName) to organize the agents within Huntress--the groupName will be used for the Huntress organization name. Since Kaseya's groupName includes the organization (e.g., group.organization) you may end up with Huntress organization names like west.company and east.company. Here are 3 potential fixes:

OPTION 1 (quickest): You can change the organization display name inside your portal and the script will continue to use the same org-key.

OPTION 2 (most robust): The deployment script will split Sub-MachineGroups into separate Huntress Organizations. Some minor modifications can make the script slightly easier to deal with if you want all clients in a Kaseya organization in the same organization in Huntress. From the Kaseya editor insert a new line into line 9 and modify line 10:

executeShellCommandToVariable("echo "#vAgentConfiguration.groupName#" | rev | cut -d "." -f 1 | rev", "SYSTEM", true, "Mac OS X", "Halt on Fail")
executeShellCommand("/bin/bash ./#workdir#/HuntressInstall.sh -a <HUNTRESS_ACCT_KEY> -o #global:cmdresults#", "Execute as System and Wait", "Mac OS X", "Halt on Fail") 

OPTION 3: Create a variable for HUNTRESS_ORG_KEY in each organization that contains the name you'd like to use. Edit line 9 of the deployment script to assign -o <HUNTRESS_ORG_KEY>.

Download and Import the Huntress Deployment Procedure

The configuration requires two simple steps:

1Download and Import the Huntress Agent Deployment Procedure

2Create a Variable to Store Your Huntress Account Key

1. Download the Huntress Agent Deployment Procedure from our GitHub repository and save it as an XML file.
2. To import the Procedure into Kaseya, navigate to Agent Procedures > Manage Procedures > Schedule / Create. Select the folder you want to import the procedure to and then click the "Import Folder/Procedure" button.
3. In the "Import Procedure/Folder" window, browse to the XML Huntress Agent Deployment Procedure you just saved and then click the "Save" button.
4. You should now see the Huntress Agent Deployment procedure.

Create a Variable to Store Your Huntress Account Key

1. Obtain your Huntress Account Key. You'll need to create a new variable to store your Huntress Account Key within Kaseya VSA.
2. Click the "Manage Variables" button.
3. In the new window, create a new variable named HUNTRESS_ACCT_KEY and set the variable value to your Huntress Account Key. Be sure to select the Org/Machine Group the variable applies to and then click the "Apply" button.

You're Ready to Deploy!

Congratulations, your Huntress Agent Deployment Procedure is ready to use. Schedule it to run and watch your agents show up within the Huntress Dashboard!

Note: Depending on VSA configuration, you may need to approve the script before running it.

Troubleshooting

1. Kaseya VSA has detailed agent logs to troubleshoot deployment. If your deployment doesn't appear to be working properly, please consult these logs and have them available for Huntress support to assist with troubleshooting. First, click on the "Agent" menu item and then "Agent Logs"
   
2. Select the agent you wish to review the logs for
   .
3. In the tabs at the top select "Agent Admins Logs" and "Procedure History."
4. Review the log for clues to why the deployment didn't go as expected. Provide these logs to Huntress support if requested.