Kaseya

*This integration was designed and built for Kaseya's on-premise product.

The .zip file contains all of the components required by xMatters and Kaseya. Download the workflow .zip file to a location on your local machine, and extract the contents.

If you navigate through the folders, you will find another .zip file called Kaseya.zip. This is the workflow which contains pre-configured forms, properties, and messages specifically designed for Kaseya. Do NOT extract the contents of the workflow .zip file — you'll import it directly into xMatters.

If you're a Linux user, download the xM-Kaseya_1_0.tar.gz file and store it in an easy-to-find location on your local machine.

Integration components

This integration requires a user who can authenticate REST web service calls when working with alerts. These permissions are provided by the "REST Web Service User" role in xMatters. See Create an integration user for more information.

Keep the user ID and password of this user handy — you'll need them when configuring other parts of this integration.

The next step is to import the workflow which contains information specifically designed for Kaseya.

1. In xMatters, click the Workflows tab, and then click Import.
2. Browse for the components\xmatters\Kaseya.zip file you downloaded, or drag it onto the Import Workflow dialog box.
3. Click Import Workflow.
   • Once the import is finished, the workflow should be automatically enabled. If it isn't, click the Disabled toggle to enable it.
4. Click the gear icon beside the workflow, and select Editor Permissions.

5. Add the integration user, and then click Save.
6. Click the workflow name to open the Forms tab.
7. For the first form in the list, click the Web Service drop-down, and then select Sender Permissions.

8. Add the integration user, and then click Save Changes.
9. Repeat steps 7-8 for each of the other forms.

1. Copy the \components\kaseya\shellcommanddef\xMCommandDef.xml to the C:\Kaseya\xml\SDProcShellCommand\0 folder. This contains the script name and parameters and makes them available to the procedure.

2. Log in to the Kaseya application: http://servername/vsapres/web20/core/login.aspx where "servername" is the hostname of the Kaseya 7.0 server.
3. Navigate to Service Desk > Procedures Definition > Stage Entry or Exit. Click on the appropriate folder and click Import Folder/Procedure:

4. Either navigate to components\kaseya\procedure\xMProcedure.xml in the extracted .zip file, or paste in the contents and click Save.

By default, this will fire for tickets with an Urgent priority. Update the procedure to match your business needs:

5. Next, go to Service Desk > Desk Configuration > Desk Definition and select the appropriate desk. Click on the Processing tab and then the Stage sub-tab:

6. Click on the New stage and click Edit to bring up the Edit Stage dialog box.
7. On the Procedures tab in the Stage Entry box, select the newly created procedure and click Save:

Navigate to the Service Desk > Common Configuration > Procedure Variables and add variables for each item with the corresponding value below:

The Windows Powershell script facilitates the communication between Kaseya and xMatters through the REST web service calls and consequently, this script must reside on the Kaseya server.

For on-premise installations, copy all the ps1 files in components\kaseya\shell_script to a folder on the Kaseya server. Note the install directory and update the xM_Script_Path appropriately. The xM.log file will be created automatically.

For on-demand instances, contact Kaseya for help with this step.

Update folder permissions

The permissions on this folder must be updated to allow Kaseya to read and write to the folder.

To update the folder permissions:

1. Right click on the folder and click Properties to display the folder properties dialog box. Click the Security tab:

2. Click the Edit button to display the Permissions dialog box, then click Add:

3. Enter IIS_IUSRS and click Check Names:

4. Click OK.
   • The Permissions dialog box is re-displayed with the IIS_IUSRS added. Make sure the Write permission has a check under Allow:

5. Click OK.