Kaseya VSA Integration

Kaseya Virtual System Administrator (VSA) is a cloud-based Remote Monitoring and Management software. Specifically designed for use by IT teams and Managed Service Providers, it unifies the monitoring of system infrastructure and their endpoints.
Here you have a step-by-step guide to help integrate it with your Emsisoft Endpoint Protection:

Configuring organizations and adding devices

1. Go to Configuration > Organizations. Click the Add button then select Organization.
   
2. In the Add Organization form, input the name of the organization and the organization type. Click Add once done.
   
3. After adding the organization, click the Add Site button to add a site under our Emsisoft organization.
   
   
4. Input the site name then click the Add button to add the site.
   
   
5. After adding the site, you can now add an agent group under it. Click on the Add Agent Group button to do this.
   
   
6. In the Add Agent Group window, enter the agent group name (in our example “Test”) then click Add.
   
   
7. After successfully creating the agent group, select it and on the left side tab select Downloads. Choose the OS that’s appropriate for your device that you will be adding.
   
   
8. Once you are in the download agent installer form, you have two options to download the agent installer. You can choose to download it directly or copy the download link.
   
   
9. After downloading and installing the agent in the target machine, the device will now appear in the Systems tab.
   
   

Creating profile 

1. Go to Configuration > Profiles then click the New Folder button. In the new folder’s name field enter Emsisoft Policy then click the save button next to it.
   
   
2. Once the folder is created, select it then click on the New Profile button.
   
   
3. In the details page of the new profile, input the Name, Description, Policy Type and Configuration Type as shown in the screenshot below. Click the Next button to go to the profile Configuration page.
   
   
4. In the configuration page, select the Enable event log notifications tab then click on the Add Filter button.
   
   
5. Fill-in the Add Event Log Filter form with data as shown in the screenshot below. Click the Save button once done.
   
   
6. Click Create to create the new profile.
   
   

Creating Policy 

1. Go to Configuration > Policies then click on the Create New Policy button.
   
   
2. In the Create New Policy details page, fill in the data as shown in the screenshot below. Click on the Next button once done.
   
   
3. In the policy’s Configuration page, click the Assign Profile button.
   
   
4. In the Assign Profiles form, select from the list the newly created Emsisoft Protection Compliance profile then click Assign.
   
   
5. After assigning the profile click the Create button to create the new policy.
    
6. After you have created the Emsisoft policy, you can now assign this to the Emsisoft organization. Go back to the organizations list (Configuration > Organizations), then select Emsisoft. Click the Edit button to update the organization details.
   
   
7. Update the Monitoring Policy and set it to the newly created Emsisoft policy. Click the Save button once done.
   
   

Creating a scope 

1. Before moving to the scripts, we need to create a scope for our tasks that will execute our script. Go to Scopes under Systems and click Create Scope.
   
   
2. In the New Scope page, enter Emsisoft as the name of the scope. Check Windows checkbox for the System Type and then click the Edit Context button in the Context section to add scope context.
   
   
3. In the Edit Context window, check the organization that we created then click the Confirm button.
   
   
4. After selecting the context, click the Create button to create the scope.
   
   

Preparing deployment script 

1. First, use this link to download the integration scripts. The downloaded zip file contains three scripts namely DeployEmsisoftComplianceScript.ps1, Emsisoft_Setup.ps1, and KaseyaVSAUserImpersonation.sp1. 
2. In one of your Kaseya VSA X installed devices run the VSA X Manager. Go to Settings > Runtime tab. In the PowerShell User Impersonation section, check PowerShell User Impersonation checkbox and enter your local admin credentials. Click the OK button once you are done.
   
   
3. Run regedit.exe and go to HKEY_LOCAL_MACHINE\SOFTWARE\Kaseya\PC Monitor. Copy the data of these three registry values namely PowerShellUserImpersonationPassword, PowerShellUserImpersonationPasswordCtrl and PowerShellUserImpersonationUsername.
   
   
4. Open KaseyaVSAUserImpersonation.ps1 and edit the variables in the script with the user impersonation data above. Save the updated script file.
   
   

Uploading Deployment Script and Creating Task 

1. Go to Automation > Scripts and create a new folder for our Emsisoft scripts. Click the New Folder button to do this. After creating the folder, select it then click the New Script button.
   
   
2. In the Create Script page enter the name of the script and the description. Name = Set User Impersonation, Description = Set user impersonation.
   
   
3. Turn on the Enable switch in the Windows section and then copy / paste the contents of KaseyaVSAUserImpersonation.ps1 script in the script box. Click Save once this is done.
   
   
4. Repeat steps 1 to 2 for the DeployEmsisoftComplianceScript.ps1 script. Name = Deploy Emsisoft Compliance Script, Description = Deploy Emsisoft Compliance Script.
   
   
5. Turn on the Enable switch in the Windows section and then copy / paste the contents of DeployEmsisoftComplianceScript.ps1 script in the script box. Click Save once this is done.
   
   
6. Go to Automation > Tasks then click Create Task.
   
   
7. In the Create Task page enter the name and description of the task. Set the Scope to the scope that we have previously created.
   
   
8. Go to the Scripts page then select Emsisoft from the Categories selection. Assign Set User Impersonation and Deploy Emsisoft Compliance Script scripts to this task in that specific order.
   
   
9. After setting the necessary data for our task click the Save Task button to save this task.
   
   
10. After you have created the task, it will now appear in your task list. You can hover on the task and click the Run button on the right to execute it.
    
    
11. The task’s execution status will now be seen as running. After the task has finished executing, you can View the result of the execution by clicking the view button.
    
    
12. In the Task Details, go to Execution History tab and click on the latest result.
    
    
13. In the Task Execution details page click on the Systems tab to view all system’s execution result. You can click on each system to view the result details.
    
    
14. Once the Emsisoft compliance script has been successfully deployed, you can now start receiving notifications when Emsisoft protection becomes non-compliant. Go to Systems > Notifications to view notifications. The screenshot below shows that Emsisoft protection is not installed.
    
    

Uploading Setup Script and Creating Task 

1. 1. Go to Automation > Custom Fields then click Create Custom Field.
      
      
   2. In the New Custom Field page, input the name and description of the field. 
      
      
   3. Set the Global Value to a temporary value and make it read-only. You need to change this value to a real install token value when you run the task that uses the script where this custom field is used. Basically, this custom field is used in the setup script. Click the Create button to create the custom field.
      
      
   4. After creating the custom field, go to Automation > Scripts and select the Emsisoft folder then click the New Script button.
      
      
   5. In the Create Script page enter the name of the script and the description as shown in the screenshot below. Click on the + New button in the Inputs section to create an input variable.
      
      
   6. In the Add Variable form, enter the name of the variable and turn on the Use custom field value switch. In the Custom Field, select the field that we previously created. Click the Save Variable button once done.
      
      
   7. Turn on the Enable switch in the Windows section and then copy / paste the contents of Emsisoft_Setup.ps1 script in the script box. Click Save once this is done.
      
      
   8. Go to Automation > Tasks then click Create Task.
      
      
   9. In the Create Task page enter the name and description of the task. Set the Scope to the scope that we have previously created.
      
      
   10. Go to the Scripts page. Select Emsisoft from the Categories dropdown to see all available scripts. In the list, click the + button next to our setup script (Install Emsisoft Endpoint Protection) to add the script to the task. After setting the necessary data for our task click the Save Task button to save this task.
       
       
   11. After you have created the task, it will now appear in your task list. You can hover on the task and click on the run button on the right to execute it. Please take note to edit the Install Token custom field variable first by going to Automation > Custom Fields prior to running this task.
       
       
   12. The task’s execution status will now be seen as Running. After the task has finished executing, you can view the result of the execution by clicking the View button.
       
       
   13. In the Task Details, go to Execution History tab and click on the latest result.
   14. In the task’s Execution Details page click on the Systems tab to view all system’s execution result. You can click on each system to view the their details.
       
       
   15. Clicking on the system will display the scripts that were run and clicking further on the script will show you the script execution details.