IT Glue Integration

Activate the integration

First, you'll activate the IT Glue integration in VSA 10 and enter the IT Glue subdomain authorized to connect to your VSA 10 instance. To do so, perform the following steps:

1. From the left navigation menu in VSA 10, navigate to Integrations > IT Glue.

2. The IT Glue configuration page will load.

3. In the Integration Status section of the page, click the Enabled toggle to activate it.

4. In the Region section, select the hosting location of your IT Glue instance.

5. In the Subdomain section, input your IT Glue instance's subdomain.

   EXAMPLE  If your IT Glue URL is harknessindustries.itglue.com, the subdomain you should enter is harknessindustries.

6. Click Save.

   

7. Proceed to the next section of this article.

Create the integration user

IT Glue leverages a dedicated user account to communicate with VSA 10. Follow the workflow described below to create the user account.

IMPORTANT  The user account cannot have multi-factor authentication (MFA) or two-factor authentication (2FA) enabled via AuthAnvil. If it does, the sync with IT Glue will not work. However, VSA 10's native 2FA does not affect the integration. If the user is allowlisted in the AuthAnvil exclusion list, the user will be able to log in to VSA 10 without being prompted for MFA.

1. From the left navigation menu in VSA 10, navigate to Configuration > Teams and Users.

2. Click the All Users tab.

3. Click Create User Account.

   

4. Create a dedicated user on an administrator team. Ensure that account is clearly identifiable as the user for your IT Glue integration.

   NOTE  You should only use this account for integration purposes. If filters are applied in the VSA 10 asset list, IT Glue will not pick up the excluded items. If the credentials fail for any reason, syncing will stop until you re-enter the account's credentials.

   

5. Log in to VSA 10 with the new account to activate it. Ensure that all filters are cleared on the asset list.
6. Proceed to the next section of this article.

Next, you'll activate the VSA 10 integration in IT Glue and authenticate it with the user account you created in the previous section of this article by completing the following steps:

1. Log in to IT Glue and navigate to the Admin tab.

2. In the side navigation bar, select Account > Integrations.

3. Click + New.

4. The Choose a platform to sync your data with page will load. Scroll down to the RMM Tools section.

5. Locate the VSA X tile. Then, click its + icon.

   

6. Complete the following fields:

   • Name: Assign a label to this integration's connector. The value you input here will appear on the Integrations page.

   • VSA X Server Hostname: Enter the fully qualified domain name (FQDN) of the VSA 10 instance to which you'd like to connect.

   • Username: Provide the username of the account you created in the Create the integration user section of this article.

   • Password: Input the password of the account you created in the Create the integration user section of this article.

7. Click Connect.

   

8. Once the initial handshake and sync completes, you'll be prompted to select whether you'd like to map your IT Glue organizations to Orgs or Machine Groups. Choose one of the following options:

   • Orgs: Enables you to map your VSA 10 organizations to top-level organizations in IT Glue

   • Machine Groups: Enables you to map VSA 10 agent groups to IT Glue organizations and sub-organizations

   You can change this preference at any time. If you do so, your existing mappings will be reset. For more information about IT Glue sub-organizations, refer to our knowledge base article.

9. Select the Enable access from VSA X check box. Doing so permits IT Glue attachments, passwords, related items, recent versions and notes to be viewed directly in VSA 10.

10. Click Save to enable the integration.

    NOTE  Enabling the integration may result in Kaseya data center IP addresses appearing in your activity logs.

    

11. Proceed to the next section of this article.

The final step in the setup process involves initiating the first data sync so that the integration can discover your VSA 10 organizations and agent groups and match them to their IT Glue counterparts. After the sync completes, you'll need to review and manually action any entities that the integration was unable to automatically match.

Perform a manual sync

The manual sync process will import your VSA 10 organizations and agent groups and attempt to match them to their IT Glue counterparts. To begin the import:

1. In IT Glue, click the Admin tab. Then, in the side navigation bar, select Account > Integrations.

2. Next to the VSA X entry, click the Actions drop-down menu. Then, click Start Manual Sync.

   

3. IT Glue will begin to import and match your VSA 10 organizations and agent groups. During this process, the Status column will read Syncing.

4. When the process finishes, the Status column will change to OK.Proceed to the next section of this article.

Review and match organizations

Following the initial sync and automatic matching, it's important to review the results of the import to check for and manually map any unmatched organizations. To do so:

1. In IT Glue, click the Admin tab. Then, in the side navigation bar, select Account > Integrations.

2. Next to the VSA X entry, click the menu. Then, click Matching.

   

3. On the VSA X Group Matching page, click the Unmatched filter.

4. Review any unmatched organizations. If IT Glue has a mapping recommendation, it will appear in the Suggested Match column.

   

   • If you're happy with a suggested match, click its menu. Then, select Accept Suggested Match.

   • If there is no suggested match, or you'd like to edit the match, you can select a different organization by clicking the corresponding Match Organization box in the Match To column.

   • If there are no available organizations in the Match Organization box, and you'd like to create one, select the boxes beside any unmatched entities you'd like to map in IT Glue. Then, click Bulk Actions > Create Organization at the bottom of the page.

     IMPORTANT  To avoid duplicate entities, before creating an organization from the matching screen, ensure that no corresponding organization already exists.

5. After completing your organization review, proceed to the next section of this article.

Review and match configurations

The last step you'll need to take in the integration deployment is to check for and map any unmatched configurations. To get started:

1. From the VSA X Group Matching page, click the Matched filter.

2. Any organization displaying a count of matched devices that does not equal the total number of devices in the Unmatched Systems column requires review. Click its menu and select Match Devices.

   

3. You'll be redirected to the System Matching page for the selected organization. For each unmatched configuration, you can either use its menu to accept the suggested match or create a new configuration, or you can manually reassign the configuration by searching for a name in the Match To column.

   We do not recommend that you create configurations in your RMM platform if your intent is to have them populate from IT Glue to your PSA solution. New items created in this way will not automatically sync with your PSA unless you manually edit and save each item.

   NOTE  Before you create configurations, try to match the devices by MAC addresses or serial number. Only after you've verified that the devices do not exist in IT Glue should you create them.

   

4. Repeat this process for each organization until you've matched all unmatched configurations are actioned. Once you've done so, the IT Glue integration setup is complete.