Guides
sevco.io

ServiceNow CMDB Inventory Sync

About

The ServiceNow CMDB is a database that stores information about assets and services. It enables a variety of powerful workflows for managing and automating your IT and security controls.

Why You Should Integrate

Managing your IT ecosystem and getting accurate, up-to-date asset records into the CMDB is a significant challenge for most enterprises. The Aurora ASM Connector bridges this gap by feeding your Aurora ASM asset data directly into the ServiceNow CMDB. You can then leverage all of your existing ServiceNow workflows with the confidence that you're operating on the most comprehensive asset data possible.

How Does the Integration Work

This integration pulls Aurora ASM device data on a scheduled cadence. It stores each device as a record in the Aurora ASM Object table and, if configured to do so, the record is merged into the Hardware table of the CMDB. Throughout this process, Aurora ASM tags are applied and synchronized to both Aurora ASM Object and Hardware records. This enables users to perform searches and workflows based on those tags. If any stale records are found during the collection process, they will be retired from the CMDB. See Configure additional properties for more details on how you can control which of these actions the integration performs.

Configuration

Aurora ASM App Installation

  1. Request Update Set Contact Aurora ASM ([email protected]) or reach out to your CSM to receive the Aurora ASM Connector update set. It will be distributed as an XML file.
  2. Retrieve Update Set In the left navigation menu of ServiceNow, search for Update Set and click Retrieved Update Sets.
  3. Import Update Set Under the Related Links section, click Import Update Set from XML. Click Choose File and navigate to the Aurora ASM Connector update set XML file on your Desktop. Click Open or double-click to select it. This will bring you back to the Import page. Click Upload to start the import process. The update set will be displayed in the Retrieved Update Sets window in a Loaded state.
  4. Preview Update Set Click Update set record. On the update set record, click Preview Update Set to preview the changes that are captured in the update set. During the update, you may get an error because of the conflicts between the files present in update set and the files which are already present in the ServiceNow. Click Close. Address any errors or conflicts that may have occurred, or click the check for select all on the errors and choose the action Accept remote update. Click Commit Update Set. When you are done, refresh the browser window to ensure the changes take effect. You can now continue to configuration.

Aurora ASM App Configuration

After installing the Aurora ASM Connector in your ServiceNow instance, you'll need to configure it with an Aurora ASM API key.

  1. Navigate to Properties: In the left navigation menu of ServiceNow, search for Aurora ASM. Under Administration, click the Properties menu option to bring up the Aurora ASM Connector configuration menu.

  2. Provide an API key: In the API key field, supply a valid Aurora ASM API key. If needed, you can create a new API key using the instructions here.

  3. Provide your Org ID: If your Aurora ASM user is a member of more than one organization, you will also need to supply the Aurora ASM Org ID in the Org ID field of the properties menu.

  4. Configure additional properties (Optional): By default, all configuration options are set to false, including the property for importing Aurora ASM data into the CMDB. We recommend reviewing these options, and enabling the ones that align with your intended use case. Below are descriptions of all currently supported properties.

    • API Key: Aurora ASM API key used to pull asset data from the Aurora ASM platform
      (Required)
    • Org ID: Aurora ASM Org ID of the tenant you want to pull Aurora ASM data from. If the API key you provide is only part of a single org, this parameter is optional.
    • Import to CMDB: If true, Aurora ASM devices will be transformed and merged into the CMDB Hardware table. (Recommended: true)
    • Import Model Data: If true, Aurora ASM will import model data into the CMDB’s Hardware Model table, and link it to the associated Hardware record.
      (Recommended: true)
    • Import Manufacturer Data: If true, Aurora ASM will import hardware manufacturer data into the CMDB’s Core Company table, and link it to the associated Hardware record.
      (Recommended: true)
    • Skip cleanup of old records: If true, Aurora ASM will not clean up devices that are no longer part of the inventory. We suggest leaving this property false to ensure your inventory is as accurate as possible.
      (Recommended: false)
    • Correlation Rules: JSON list of correlation rules to check in order to determine if an Aurora ASM device already exists in the CMDB Hardware table during mapping. This property should almost never be modified.
    • Log Level: Adjusts the logging verbosity reported by the Aurora ASM Connector. Default is info.

  5. Save: Click the Save button to save your selections.

📘

NOTE

The connector will run on a schedule, but a manual execution can be performed if you want to pull results immediately. To do this, follow the steps below:

  1. Navigate to Scheduled Jobs: In the left navigation menu of ServiceNow, search for Aurora ASM, then click the Scheduled Jobs menu item.

  2. Choose Aurora ASM Device Collection: From the list of schedules, click the Aurora ASM Device Collection schedule.

  3. Execute: In the top right corner of the schedule page, click Execute Now.

Viewing Asset Data

Once the collection job has finished executing, you can view the results in a few ways.

  1. Aurora ASM Devices: All devices that were imported are stored in the Aurora ASM Object table. This can be viewed by clicking the Aurora ASM Devices menu item in the left navigation menu of ServiceNow. Clicking the ID of the record will bring up a more comprehensive details view for that asset.

  2. Discovered Hardware: If you chose to import Aurora ASM asset records to the CMDB during configuration, you can also click the Discovered Hardware menu item in the left navigation menu of ServiceNow. This will bring up a view of the Hardware table in the CMDB showing you all records imported by Aurora ASM. Clicking the name of the Hardware record will bring up a more comprehensive details view for that asset.

Contact Us

If you're having problems configuring an Integration, or if you've found something wrong in this document, please email us at [email protected].

Updated 4 days ago