Kaseya VSA X integration

If you’re new to integrations in Rewst, read through our introductory integration documentation here.

What does the Kaseya VSA X integration do?

Our Kaseya VSA X integration enables automation of remote monitoring and management. Use the Kaseya VSA X API within Rewst worfkflows to automate tasks such as obtaining asses inventory, executing commands, and running procedures on endpoints.

Set up the Kaseya VSA X integration

Set up steps in Kaseya

1. Log in to the Kaseya VSA X Admin Console. You will need to have administrator privileges to create API tokens.

2. Navigate Administration > Server Admin > Overview.

3. Copy the Name under the Server Information submenu.

4. Paste the copied name value into the hostname parameter field IN REWST?

5. Navigate to Administration > Configuration > API Access.

6. If prompted, re-enter your account password.

7. Click Create Token.

8. Name your token. Enter a descriptive name for your token in the Create token dialog box. This will help you to identify the token later. Don't set an expiration date for the token.

9. Click Next.

10. If you want to limit the ip address access for the API token, specify the IP address of Rewst by entering the following into the IP White List field: {rewst_outbound_ip_addr}.

11. Configure your token permissions to have access to your chosen organizations and API permissions in which you want to have access to in Rewst.

12. Click Create Token.

13. Copy the value for the Token ID and Token Secret. Store these somewhere secure, as you won't be able to view them again once you move away from this page. You'll need both for further steps in Rewst.

Set up steps in Rewst

1. Navigate to Configuration > Integrations in the left side menu of your Rewst platform.

2. Search for Kaseya VSA X in the integrations page.
3. Click on the integration tile to launch the configuration setup page.

4. Under Parameters, enter the information copied from Kaseya into the relevant fields:

   1. Hostname: Kaseya VSA X server hostname, e.g. example.kaseyalab.com

   2. Token ID

   3. Token Secret

5. Click Save Configuration.

6. Rewst will do a quick validation of your input. Once completed, you'll see a new section beneath the configuration form for organization mapping. Complete your mapping as desired.

Migrate from Kaseya VSA integration to Kaseya VSA X

1. Configure the new Kaseya VSA X integration from the instructions above.

2. Update the default_rmm organization variable to be kaseya_vsa_x

OR

Re-run the config orgs form to choose Kaseya VSA X as their default RMM.

1. Create a script called Run Powershell (Rewst) with the inputs post_url and script_url:

and the contents:

Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$wc = New-Object System.Net.WebClient
$wc.Encoding = [System.Text.Encoding]::UTF8
$commands = ($wc.DownloadString("$script_url"))
iex $commands

Optionally, reduce API calls to Kaseya by setting an org var called kaseya_vsa_10_scriptid with the GUID value of the above script.

Actions and endpoints

Category	Action	Description
Device	List Devices	Returns a list of devices.
Device	Get Device by ID	Returns the device details.
Generic Request	Kaseya VSA X API Request	Generic action for making authenticated requests against the Kaseya VSA X API
Script	List All Automation Scripts	Returns a list of automation scripts.
Script	Get a Specific Automation Script by ID	Returns the automation script details.
Script	Run Automation Script	Runs a specific automation script