VSA X device mapping

About the device mapping feature

Devices Your Autotask instance may be configured to use one of the following terms instead: Asset, Configuration Item, Installed Asset, Installed Product. associated with selected (or all) contexts in VSA X can now be synchronized with Autotask. The range of VSA X device fields that are available in Autotask are similar to the ones available with the Datto RMM integration, and are presented in a Details from VSA X section on the Device page.

Importantly, the integration will allow the VSA X integration to set up the Mac Address of mapped devices in Autotask. This address is visible to other integrations such as Datto RMM or IT Glue, and will prevent the creation of duplicate devices in Autotask if multiple Kaseya IT Complete applications referencing the same device are connected.

Configuration

The integration is mostly configured in VSA X, but it requires that a dedicated API user is created for the Integration Vendor Kaseya - VSA X - RMM. This API user will be used by VSA X for authentication.

To set up the API user, do the following:

  1. Navigate to > Admin > Extensions & Integrations > Other Extensions & Tools > Integration Center.
  2. On the Vendors tab, scroll to Kaseya - VSA X - RMM.
  3. From the context menu, select Add API User. The Add API User - Kaseya - VSA X - RMM window will open.
  4. Follow the general directions for Adding or editing an API user.
  5. If you are creating the API user on the > Admin > Organization Your Autotask instance may be configured to use one of the following terms instead: Account, Business Unit, Client Company, Customer, Site. Settings & Users > Resources/Users (HR) > Resources/Users (HR) > Resources/Users > New > New API User page, make sure Kaseya - VSA X - RMM is selected as the Integration Vendor.
  6. Copy the Username (Key) and Password (Secret) into Notepad for pasting them into the VSA X Autotask integration page.
  7. Open VSA X and complete the integration setup.

Once the integration is configured in VSA X, devices will be created for mapped contexts/organizations, and tickets according to notification criteria.

UI changes if the integration is enabled

Once the integration has begun syncing devices to Autotask, you will notice the following changes in the Autotask UI:

IMPORTANT  Devices created by VSA X cannot be moved, copied or deleted.

  • On the Device Category > General tab, the Details from VSA X section appears and is visible by default.
  • On the Device Category > Insights tab, the VSA X Device insight appears but is hidden by default.
  • The section and the insight only appear on the Device page if the device is in fact associated with VSA X.
  • On the Device page of devices synced from VSA X, you will see the Details from VSA X section.
  • The VSA X Device insight is available on the Insights panel of devices and tickets linked to VSA X.
  • Click on Device to open the corresponding record in VSA X.

NOTE  The visibility of that section is controlled by the device category.

  • On the Device Search page, a filter and a column called Associated with VSA X are now available.
  • On other pages where devices appear (Organization, Contract, and Contact pages), the Associated with VSA X column is available.

NOTE  Items associated with VSA X cannot be deleted, merged, or moved.

  • On the ticket search pages and tables, you can display the Device Associated With VSA X column.
  • In device workflow rules, Associated with VSA X is available as a condition.
  • In ticket workflow rules, Device Associated with VSA X is available as a condition.
  • In Device widgets, Associated with VSA X is available as a grouping and filtering criteria.
  • In Ticket widgets, Device Associated with VSA X is available as a grouping and filtering criteria.
  • Additionally, you can group and filter on all device fields populated from VSA X with the exception of the following:
    • Maintenance Mode
    • MDM Enrolled
    • Device ID

On ticket boards, Device Associated with VSA X can be added as a filter to the "On Deck" section.

When you open a contract and navigate to the Devices tab, the Devices Under This Contract and Devices Not Under Any Contract tables allow you to select the the Is Associated with VSA X column from the column chooser.

Contacts cannot automatically be associated with devices. You can manually associate them on the Device Mapping page. Refer to Map the device to a contact.

SECURITY  This page is accessible to users who have the BCDR integration enabled, have access to the Device Discovery wizard, and have access to all devices. Refer to Mapping discovered devices to a contact and contract.

On the Device Mapping page, we added VSA X as a filter to the Discovered By field.

Only the integration can set the Device ID. Import, API, copying or manual creation cannot set the Device ID.