Mac Agent - Kaseya VSA Installation

Introduction

You can Follow this article to install the macOS Blackpoint SNAP-Defense agent to your customer network using your Kaseya VSA tool. We've broken down the installation into the following steps:

  1. Copying the SNAP Agent URL
  2. Importing the script
  3. Setting the variables
  4. Deploying the agent
  5. Verify Mac Agent Deployed successfully. 

Prerequisites

  • Your Mac Must be Running macOS 10.15 or later

Instructions

Copying the Mac Agent URL

  1. From the Blackpoint Partner Portal, navigate to the Blackpoint Add-Ons Portal. 
  2. From the customer switcher, select the customer for mac agent deployment. 
  3. Navigate to Install and Deploy from the navigation menu in the Blackpoint Add-Ons Portal. 
  4. Download mcOS Setup Script.
  5. Open the macOS setup script (.sh file) in your code editor or notepad and copy the AUTH_TOKEN and CUSTOMER_IDbetween the quotation marks. 

Importing the Script

  1. Download the .xml install script. Right-click this link and click Save Link As... Remember where you save this file as you will need it in the steps below.
  2. Once the file is downloaded, you will need to import it to the VSA. Log into Kaseya VSA and navigate to Agent Procedures > Schedule/Create.
  3. Under the Shared directory, select an existing folder, or click New Folder to create a "Blackpoint" folder to store your Agent Procedure. Click Import Folder/Procedure at the top of the screen.

  4. In the Import Folder/Procedure pop-up window, upload the .xml file you downloaded in Step 1 of this section. Click Save.

Setting the Variables

  1. In the Shared folder, click the BlackPoint SNAP Mac Installer procedure file. Then, click Manage Variables at the top of the screen.

  2. Create a new variable called Auth_Token
    1. Type Auth_Token into the Rename/Create Variable field.
    2. Paste the Auth_Tokenfrom the script you downloaded in the first sectioninto the Set Variable Value field.
    3. Select the check box next to the appropriate customer below and click Apply to append the variable to that customer.
  3. Create a second new variable called Customer_ID
    1. Type Customer_ID into the Rename/Create Variable field.
    2. Paste the Customer_ID from the script you downloaded in the first section into the Set Variable Value field.

    3. Select the checkbox next to the appropriate customer below and click the Apply button to append the variable to that customer. 

Deploying the Agent

  1. Schedule a task with this procedure on the correct endpoints. To do so, select the agent procedure and check the box(s) next to the appropriate endpoints. You can then click Schedule Agent Procedure. 
  2. Set a desired Recurrence, Time Preference, Start Time/Date, and any Execution Options for the task. Click Submit.

  3. You've successfully deployed the macOS agent through Kaseya VSA to your customer's network.

Verify deployment has been successful;

  1. Open SNAP-Defense in your web browser
  2. Select Customer using the drop-down selection list
  3. Navigate to the "Collection" menu in SNAP-Defense and confirm your Mac shows in the device list Additionally, you can navigate to the "Network" menu and confirm the device shows in the network map
  4. Additionally, navigate to the “Network” menu to check if the device shows in the network map

You've successfully deployed the Mac Agent to your customer's network.