CMDB classes targeted

Viewing class mappings

You can view the available class mappings for the Service Graph Connector Integration for Claroty CTD by navigating to All > Service Graph Connector Claroty CTD > Class Mappings. In the class mappings table, you can view the following attributes.

Tableau 1. Class mapping attributes
Field	Description
Source Class	The class of the source CI.
Target CMDB class	The expected ServiceNow class for the CI.
OT Device type	The category type that the OT device is classified as. The device type is also the function that the device plays on the OT network. For example: An IT device, such as a server, can be converted to an OT device, and the function it plays on the network is an HMI. Therefore, its class is server and its device type is HMI. Remarque : In some cases, there are OT devices with no OT function or OT devices where the device type is unknown. For OT devices with no OT function, select No OT Function. For OT devices where the device type is unknown, select Unknown.
Allow OS classification	When set to True, if an operating system is found on the CI, the target is switched away from the target CMDB class to a ServiceNow class that matches its OS.
Active	When checked, the class mapping is set to Active.

The Service Graph Connector Integration for Claroty CTD also uses Claroty types and codes. For more information, see the Default class mapping table.

Computer [cmdb_ci_computer]

The following attributes in the Computer [cmdb_ci_computer] table are populated by collected data:


Attribute label	Attribute name
Most recent discovery	last_discovered
Operating System	os
OS Version	os_version

External system metadata [cmdb_key_value_v2]

The following attributes in the External system metadata [cmdb_key_value_v2] table are populated by collected data:


Attribute label	Attribute name
Discovery source	discovery_source
Key	key
Source key	source_key
URL value	url_value
Value type	value_type

Firmware Installation [cmdb_firmware_install] 

The following attributes in the Firmware Installation [cmdb_firmware_install]  table are populated by collected data:


Attribute label	Attribute name
Source Native Key	firmware_version_snk
IRE criterion attribute	firmware_ire_criterion_key
Discovered version	firmware_version_cleansed
Discovery source	firmware_version_discovery_source

Hardware [cmdb_ci_hardware]

The following attributes in the Hardware [cmdb_ci_hardware] table are populated by collected data:


Attribute label	Attribute name
Change Group	assignment_group
Support group	support_group
Company	company
Vendor	vendor
Name	name
Serial number	serial_number
Class	sys_class_name
First discovered	first_discovered
Location	location
Model number	model_number
Most recent discovery	last_discovered
Supported by	supported_by
Assigned to	assigned_to
Managed By Group	managed_by_group
Managed by	managed_by
Model ID	model_id
Approval group	change_control
Owned by	owned_by
Manufacturer	manufacturer

Tableau 2. Relationships created for Hardware
Parent class	Relationship type	Child class
Hardware [cmdb_ci_hardware]	Owns::Owned by	Network Adapter [cmdb_ci_network_adapter]
Hardware [cmdb_ci_hardware]	Owns::Owned by	IP Address [cmdb_ci_ip_address]
Hardware [cmdb_ci_hardware]	Reference	OT Device [cmdb_ot_entity]
Hardware [cmdb_ci_hardware]	Reference	External system metadata [cmdb_key_value_v2]
Hardware [cmdb_ci_hardware]	Reference	Software Installation [cmdb_sam_sw_install]

IP Address [cmdb_ci_ip_address]

The following attributes in the IP Address [cmdb_ci_ip_address] table are populated by collected data:


Attribute label	Attribute name
Owned By Configuration Item	owned_by_cmdb_ci
IP Address	ip_address
IP version	ip_version

Tableau 3. Relationships created for IP Address
Parent class	Relationship type	Child class
IP Address [cmdb_ci_ip_address]		Network Intrusion Detection System [cmdb_ci_nids]
IP Address [cmdb_ci_ip_address]		Hardware [cmdb_ci_hardware]

Network Adapter [cmdb_ci_network_adapter]

The following attributes in the Network Adapter [cmdb_ci_network_adapter] table are populated by collected data:


Attribute label	Attribute name
MAC Address	mac_address
Name	name

Tableau 4. Relationships created for Network Adapter
Parent class	Relationship type	Child class
Network Adapter [cmdb_ci_network_adapter]	Reference	Hardware [cmdb_ci_hardware]

Network Intrusion Detection System [cmdb_ci_nids]

The following attributes in the Network Intrusion Detection System [cmdb_ci_nids] table are populated by collected data:


Attribute label	Attribute name
Manufacturer	manufacturer
Name	name
Correlation ID	correlation_id
Description	short_description
Firmware version	firmware_version
NIDS manager connection state	connection_state
Life Cycle Stage Status	life_cycle_stage_status
Life Cycle Stage	life_cycle_stage
Validated	validated

Tableau 5. Relationships created for NIDS
Parent class	Relationship type	Child class
Network Intrusion Detection System [cmdb_ci_nids]	Owns::Owned by	IP Address [cmdb_ci_ip_address]
Network Intrusion Detection System [cmdb_ci_nids]	Detects::Detected by	Hardware [cmdb_ci_hardware]

Operational Technology (OT) [cmdb_ci_ot]

The following attributes in the Operational Technology (OT) [cmdb_ci_ot] table are populated by collected data:


Attribute label	Attribute name\
Firmware version	firmware_version
Most recent discovery	last_discovered

OT Device [cmdb_ot_entity]

The following attributes in the OT Device [cmdb_ot_entity] table are populated by collected data:


Attribute label	Attribute name
Purdue level	purdue_level
ISA entity site	isa_entity_site
OT discovery source ID	ot_correlation_id
Device criticality	business_criticality
Zone	zone
OT device type	ot_asset_type
IRE criterion attribute	ire_criterion_attribute

OT Control Module [cmdb_ci_ot_control_module]

The following attributes in the OT Control Module [cmdb_ci_ot_control_module] table are populated by collected data:


Attribute label	Attribute name
Location	location
Supported by	supported_by
Name	name
Serial number	serial_number
Slot number	slot_number
Manufacturer	manufacturer
Firmware version	firmware_version
Approval group	change_control
Assigned to	assigned_to
Most recent discovery	last_discovered
Model ID	model_id
Model number	model_number
Company	company
Owned by	owned_by
Managed by	managed_by
Support group	support_group
Managed By Group	managed_by_group
Change Group	assignment_group
Vendor	vendor

Tableau 6. Relationships created for OT Control Module
Parent class	Relationship type	Child class
OT Control Module [cmdb_ci_ot_control_module]	Reference	OT Device [cmdb_ot_entity]

OT Control System [cmdb_ci_ot_control]

The following attributes in the OT Control System [cmdb_ci_ot_control] table are populated by collected data:


Attribute label	Attribute name
Has module	has_module
Most recent discovery	last_discovered

Tableau 7. Relationships created for OT Control System
Parent class	Relationship type	Child class
OT Control System [cmdb_ci_ot_control]	Owns::Owned by	OT Control Module [cmdb_ci_ot_control_module]

Serial Number [cmdb_serial_number]

The following attributes in the Serial Number [cmdb_serial_number] table are populated by collected data:

Remarque :

A fix script is automatically applied to clean up the serial number [cmdb_serial_number] records imported into the sys_object_source table from the Service Graph Connector. The script ensures that a null pointer exception doesn't occur when a serial number and MAC address are the same.

This fix script only runs once during the upgrade of Service Graph Connector Integration for Claroty CTD but doesn't run on zbooted instances or fresh installation. This doesn't affect the functionality or lead to any data loss.


Attribute label	Attribute name
Serial Number	serial_number
Serial Number Type	serial_number_type
Valid	valid

Tableau 8. Relationships created for Serial Number
Parent class	Relationship type	Child class
Serial Number [cmdb_serial_number]	Reference	Hardware [cmdb_ci_hardware]

Software [cmdb_ci_spkg]

The following attributes in the Software [cmdb_ci_spkg] table are populated by collected data:


Attribute label	Attribute name
Key	key
Version	version
Manufacturer	manufacturer
Name	name

Tableau 9. Relationships created for Software
Parent class	Relationship type	Child class
Software [cmdb_ci_spkg]	Reference	Software Instance [cmdb_software_instance]

Software Instance [cmdb_software_instance]

The following attributes in the Software Instance [cmdb_software_instance] table are populated by collected data:


Attribute label	Attribute name
Install date	install_date
Installed on	installed_on
Name	name

Tableau 10. Relationships created for Software Instance
Parent class	Relationship type	Child class
Software Instance [cmdb_software_instance]	Reference	Hardware [cmdb_ci_hardware]

Software Installation [cmdb_sam_sw_install]

The following attributes in the Software Installation [cmdb_sam_sw_install] table are populated by collected data:


Attribute label	Attribute name
Display name	display_name
Version	version
Discovery source	discovery_source

Tableau 11. Relationships created for Software Installation
Parent class	Relationship type	Child class
Software Instance [cmdb_software_instance]	Reference	Hardware [cmdb_ci_hardware]

Default class mapping

A default class mapping is shipped with the Service Graph Connector Integration for Claroty CTD application.