xMatters & Kaseya Integration

The information in this article is the intellectual property of xMatters and is intended only for use with xMatters products by xMatters customers and their employees. Further, this intellectual property is proprietary and must not be reused or resold.

 

Kaseya provides IT management software that helps MSPs and mid-sized enterprises better manage IT to drive the success of their businesses. Kaseya Virtual System Administrator (VSA)  is an IT Systems Management platform that can be leveraged seamlessly across IT disciplines to streamline and automate IT services. By integrating with xMatters, Kaseya gets the power of intelligent multi-channel delivery, management and action to reducs time to resolution and customer impact.

Installation and Configuration

Installation and Configuration

Requirements

Application Version
xMatters On-Demand 5.5.57+
Kaseya VSA Service Desk

7.0.0

Note: This integration was designed and built for Kaseya's on premise product. 

Installing the Integration

Integration components 

Kaseya.zip The REB Communication Plan to import into xMatters

procedure
+- xMProcedure.xml

The procedure to import into Kaseya
shell_script
+- xMatters.ps1
+- xMFunctions.ps1
The PowerShell script and Function library to generate the REST request to xMatters
shellcommanddef
+- xMCommandDef.xml
The command definition file that serves to map the parameters from the procedure to the shell script 

Configuring xMatters

Create an integration user

This integration requires a user who can authenticate REST web service calls when injecting events.

This user needs to be able to work with events, but does not need to update administrative settings. While you can use the default Company Supervisor role to authenticate REST web service calls, the best method is to create a user specifically for this integration with the "REST Web Service User" role that includes the required permissions and capabilities.

Note: If you are installing this integration into an xMatters trial instance, you don't need to create a new user. Instead, locate the "Integration User" sample user that was automatically configured with the REST Web Service User role when your instance was created and assign them a new password. You can now skip ahead to the next section.

To create an integration user:

  1. Log in to the target xMatters system.
  2. On the Users tab, click Add.
  3. Enter the appropriate information for your new user. Because this user will affect how messages appear for recipients and how events will be displayed in the reports and Communication Center, you may want to identify the user as specific to Kaseya; for example:
    • First Name: Kaseya
    • Last Name: Integration
    • User ID: kaseya
  4. In the Roles area, add the REST Web Service User role.
  5. Click Add.

Make a note of the user credentials and details; you will need them when configuring other parts of this integration.

Import the communication plan

Next, navigate to the Developer tab and click Import Plan.

 Select the components\xmatters/Kaseya.zip file and click Import Plan:

By default, the plan is disabled when imported. Click the checkbox to enable it:

Then enable the Web Service operation for each form by clicking Edit > Forms and selecting Create Event Web Service for each:

Then click the Permissions item for each and enter the integration user created above and click Save Changes. This allows that user to make REST calls to these forms.

Adding the Procedure to Kaseya

First, copy the integration\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. For on demand instances, contact Kaseya to have this file copied to the environment.

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

Either navigate to the xMProcedure.xml 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 the business needs.

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:

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

Configure Procedure Variables

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

xM_Default_Group The default group to notify if the Ticket does not have a Pool nor an Assignee All

Kaseya Service Desk

 
xM_Host

The hostname including https of the xMatters system

All https://acme.na1.xmatters.com  
xM_Pass

Password for authenticating to the REB endpoint

All passwordhere The password can also be stored on the Kaseya server in the xM_Script_Path folder in a file called xMPassword.txt.
xM_Script_Path

The path to the xMatters script file

All C:\xMScripts See the section below on granting privileges to this folder
xM_User The user name used to authenticate to the xMatters REB endpoint All kaseya The user created above. 

Deploy Shell Script

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.

Important: The permissions on this folder must be updated to allow Kaseya to read and write to the folder. Right click on the folder and click properties to display the folder properties dialog. Click the Security tab:

Click the Edit.. button to display the Permissions dialog and click Add...

Enter IIS_IUSRS and click Check Names:

Click Ok, and the Permissions dialog is re-displayed with the IIS_IUSRS added. Make sure the Write permission has a check under Allow:

Click Ok.

Troubleshooting the Integration

The xMatters.ps1 file contains a $debug variable that will print detailed information about the REST request to the xM_Script_Path\xM.log file. Inspect this file for any errors.

xMatters Reference

JDN-4824 Originally created by Travis Depuy

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk