Ivanti Neurons for ITSM Configuration Management Database (CMDB) Connector Guide

Summary: How to set up and use the ITSM Configuration Management Database (CMDB) connector in RBVM.

Overview

The ITSM Configuration Management Database (CMDB) connector creates an integration with the ITSM CMDB module for syncing information with the RBVM platform. When the connector is configured, RBVM users can see and filter CMDB information within the platform. The ITSM user used in the connector configuration process needs read access to the CMDB CI tables that assets are stored in and write access (if configured) to the CI table created in ITSM for creating new assets.

This connector offers the flexibility to define up to 10 custom fields pulled from ITSM on top of the default fields (from the base CI table in ITSM). It allows for optional asset creation in ITSM. Additionally, it supports business criticality mapping in multiple ways to help get your asset’s business criticality synced into the platform.

CMDB support applies only to integrations and scanners that provide specific field data that exactly matches the fields and data provided by CMDB. Integrations/scanners that do not supply the required matching attributes and data may not be fully supported and may not produce the expected matching results.

Connector Configuration

Navigate to the Automate > Integrations page.

Using the search bar in the upper-right corner of the Integrations page, type CMDB to find the connector.

Locate the Ivanti Neurons for ITSM CMDB card on the page and click Configuration.

In the new window under Connection, complete the required fields, as described below.

• Connector Name: The connector’s name.

• Location (URL): URL of the Ivanti ITSM instance.

• API Key: The user’s username that has access to the Ivanti ITSM instance.

Click the Test Credentials button to ensure the credentials are correct and have the necessary access to make ITSM CMDB API calls.

Under the Connector Specific Option section, configure the following items for the connector.

Configure CMDB connectors connected to Networks: This section displays any currently configured CMDB connectors connected to networks in RBVM.

Network: This section configures what RBVM networks the connector will be limited to when syncing asset information from the ITSM CMDB module. You can select multi-networks from the drop down list.

Default Fields: All these fields are base CI fields in ITSM and will be pulled for all assets in the RBVM platform that reside in configured networks if populated in ITSM.

• Default Field - Default fields in RBVM CMDB. In addition to the existing list, you can add more default fields.

• Ivanti ITSM Field - Equivalent fields in ITSM that can be mapped with default field values.

CMDB Tables to Query:

By default, RBVM fetches all the CIs from ITSM for query.

Asset Matching Query Order: When using this connector, users have the option to set CMDB mapping by using mixed network (By All Networks - which is default). Users can select either the network type configuration or one or more individual network types with custom mappings for each of them.

By All Networks

Users can select multiple options and configure separate configuration sets for each network type.

Custom Fields: These fields can be mapped to any valid fields on your CIs in ITSM. If these fields are not there for any given CI, then they will not be populated in the platform.

Click the Save to save the connector’s configuration and create the connector. Once saved, the connector is now visible on the Integrations page under Currently Configured Integrations.

Clicking the History button displays the connector details for each pull. The Sync button allows users to perform on-demand sync. The Edit button allows the user to edit the connector configuration. The Delete button allows the user to delete the connector.

RBVM CMDB Usage

There are many ways that the RBVM platform allows you to view, edit, lock, filter, and use CMDB information synced with your RBVM assets.

General Sync Information

Once the connector is synced, if an asset previously found a matching record in ITSM CMDB, then it will keep syncing with the same record in all future sync operations even though there could be multiple matching records found in ITSM CMDB.

Custom Field Display Value Configuration

While logged into the RBVM platform, navigate to the Settings () > Client Settings page from the top-right corner of the screen.

Custom field labels can be configured in the Configuration Management Database section. This setting only affects the connector configuration screen and the host detail slide-out display value.

NOTE: When filtering for these fields, the filter category will always be “Custom Field X” and not the configured display value for the detail pane.

RBVM Fields/Status Types

Status Types

Status types are found in the Host Detail pane when looking at an asset in RBVM. They can be filtered using the filter category CMDB Sync Status on the Hosts page. Below is more information about the possible status values that a RBVM asset can have and the filter values that correspond to them.

SYNCED (Filter Value: Synced): Only one unique record found in ITSM CMDB matching the search criteria and synced.

NOT_FOUND (Filter Value: No Record Found): No record found in ITSM CMDB.

MULTIPLE_FOUND (Filter Value: Multiple Found): Multiple records were found that match the search criteria in ITSM CMDB.

RECORD_NO_LONGER_FOUND (Filter Value: Record No Longer Found): The ITSM CMDB record was found in a previous sync but not found in the latest one (e.g., the CI was deleted).

NOT_APPLICABLE (Filter Value: Not Applicable): The host is not part of any CMDB connector.

Fields

The following tables show the RBVM CMDB fields (default/configurable/custom) supported by this connector and the user interface/API.

Field Auxiliary Information

• Data Refresh: The RBVM CMDB field’s last updated time.

• Locked By: RBVM CMDB field is updated by. It can be either locked to a connector or the API/UI. Each field can be individually locked on a per asset basis.

Default Fields

There are default fields that the connector always attempts to pull if they are populated in ITSM.

RBVM Field	RBVM Filter Category	ITSM CMDB CI Field	Field Description
Operating System	CMDB Operating System	os	Asset operating system.
Manufactured By	CMDB Manufactured By	manufacturer	Asset manufacturer.
Model	CMDB Model	model_id	Asset model.
Location	CMDB Location	location	Asset location.
Managed By	CMDB Managed By	managed_by	Who manages the asset.
Owned By	CMDB Owned By	owned_by	Who owns the asset.
Supported By	CMDB Supported By	supported_by	Who supports the asset.
Support Group	CMDB Support Group	support_group	The group that supports the asset.
Last Scanned	CMDB Last Scanned	sys_updated_on	Asset’s last scanned time (scan meaning CMDB Agent or collection server).
Asset tags	CMDB Asset tags	asset_tag	Asset’s associated asset tags.
Mac Address	CMDB Mac Address	mac_address	Asset MAC address.
Unique Id	CMDB Unique Id	sys_id	Asset’s Unique ID (ITSM sys_id) of the matching record (CI).

Custom Fields

If these fields are configured in RBVM and populated in ITSM, the connector always attempts to pull these configurable fields.

RBVM Field	RBVM Filter Category	ITSM CMDB CI Field	Field Description
Business Criticality	Criticality	Mapping to CI-associated criticality OR configurable field	This can be mapped to source criticality, which comes from the business_criticality (Business Criticality) field in the cmdb_ci_service (Business Service) table. These cmdb_ci_service (Business Service) objects are associated with cmdb_ci (Configuration Items) and its child tables. If multiple cmdb_ci_service (Business Service) records are associated with a single CMDB CI, then we will take the highest of the information from ITSM. OR The asset’s Business Criticality in RBVM. This is an integer from 1 (least critical) to 5 (most critical).
Asset Compliance: FERPA	CMDB FERPA Compliance Asset	Configurable Field	A field to represent whether this asset is FERPA compliant.
Asset Compliance: HIPAA	CMDB HIPAA Compliance Asset	Configurable Field	A field to represent whether this asset is HIPAA compliant.
Asset Compliance: PCI	CMDB PCI Compliance Asset	Configurable Field	A field to represent whether this asset is PCI compliant.
Custom Field 1	CMDB Custom Field 1	Configurable Field	These fields can be mapped to anything you want and configured within RBVM to have a unique display name. NOTE: When filtering for these fields, the filter category will always be “Custom Field X” and not the configured display value for the detail pane.
Custom Field 2	CMDB Custom Field 2	Configurable Field	See Custom Field 1.
Custom Field 3	CMDB Custom Field 3	Configurable Field	See Custom Field 1.
Custom Field 4	CMDB Custom Field 4	Configurable Field	See Custom Field 1.
Custom Field 5	CMDB Custom Field 5	Configurable Field	See Custom Field 1.
Custom Field 6	CMDB Custom Field 6	Configurable Field	See Custom Field 1.
Custom Field 7	CMDB Custom Field 7	Configurable Field	See Custom Field 1.
Custom Field 8	CMDB Custom Field 8	Configurable Field	See Custom Field 1.
Custom Field 9	CMDB Custom Field 9	Configurable Field	See Custom Field 1.
Custom Field 10	CMDB Custom Field 10	Configurable Field	See Custom Field 1.