Service Graph Connector for Microsoft Defender for IoT (Azure)

Integrate Microsoft Defender for IoT with the ServiceNow® Operational Technology Manager application to automate import of OT devices and sensor appliances.

Request apps on the Store

Visit the ServiceNow Store website to view all the available apps and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the ServiceNow Store version history release notes.

Supported versions

• Supports Microsoft Defender for IoT sensor versions:
  • 22.2.3.22
  • 22.2.5.9
• Supported ServiceNow versions:
  • Utah
  • Vancouver
  • Washington

Use cases

You can use the Service Graph Connector for Microsoft Defender for IoT (Azure) with the ServiceNow® Operational Technology Manager application to import OT devices and sensor appliances.

Guided setup

The guided setup for the Service Graph Connector for Microsoft Defender for IoT (Azure) provides an organized sequence of tasks to configure the integration on your instance. To access the guided setup, see Configure guided setup.

CMDB integrations dashboard

The Integration Commons for CMDB store app provides a dashboard with a central view of the status, processing results, and processing errors of all installed integrations. You can see metrics for all integration runs. You can filter the view to a specific CMDB integration, a specific time duration, or a specific integration run. For more details about monitoring integrations in the CMDB Integrations Dashboard, see Integration Commons for CMDB.

Data mapping

Data from the Microsoft Defender for IoT (Azure) data sources is mapped and transformed into the ServiceNow CMDB Configuration Item (CI) class definitions using the Robust Transform Engine (RTE). Data is inserted into the ServiceNow CMDB using the Identification and Reconciliation Engine (IRE).

When you complete the setup, you can configure the integration to periodically pull data from the Microsoft Defender for IoT (Azure) application.

The following table lists the data sources included for a Microsoft Defender for IoT (Azure) project and the corresponding staging tables where the imported data is loaded.

Table 1. Data sources and staging tables for Microsoft Defender for IoT (Azure)

Data source	Staging table
SG-OT Azure D4IoT Devices Import	SG-OT Azure D4IoT Devices Import [sn_msftd4iotazsgc_sg_ot_azure_d4iot_devices_import]
SG-OT Azure D4IoT Sensors Import	SG-OT Msft D4IoT Sensors Import [sn_msftd4iotazsgc_sg_ot_azure_d4iot_sensors_import]

The imported data from the staging tables is then inserted into the following target tables:

• AIX Server [cmdb_ci_aix_server]
• Computer [cmdb_ci_computer]
• Configuration Item [cmdb_ci]
• DCS [cmdb_ci_ot_dcs]
• ESX Server [cmdb_ci_esx_server]
• EWS [cmdb_ci_ot_ews]
• External System Metadata [cmdb_key_value_v2]
• Game Console [cmdb_ci_game_console]
• Handheld Computing Device [cmdb_ci_handheld_computing]
• Historian [cmdb_ci_ot_historian]
• HMI [cmdb_ci_ot_hmi]
• HP-UX Server [cmdb_ci_hpux_server]
• HVAC Equipment [cmdb_ci_hvac]
• HyperV Server [cmdb_ci_hyper_v_server]
• IED [cmdb_ci_ot_ied]
• Industrial Actuator [cmdb_ci_ot_industrial_actuator]
• Industrial Drive [cmdb_ci_ot_industrial_drive]
• Industrial Robot [cmdb_ci_ot_industrial_robot]
• Industrial Sensor [cmdb_ci_ot_industrial_sensor]
• IoT Device [cmdb_ci_iot]
• IP Address [cmdb_ci_ip_address]
• IP Camera [cmdb_ci_ip_camera]
• IP Firewall [cmdb_ci_ip_firewall]
• IP Phone [cmdb_ci_ip_phone]
• Linux Server [cmdb_ci_linux_server]
• Netgear [cmdb_ci_netgear]
• Network Adapter [cmdb_ci_network_adapter]
• Network Intrusion Detection System [cmdb_ci_nids]
• Operational Technology (OT) [cmdb_ci_ot]
• OSX Server [cmdb_ci_osx_server]
• OT Control Module [cmdb_ci_ot_control_module]
• OT Control System [cmdb_ci_ot_control]
• OT Device Details [cmdb_ot_entity]
• OT Field Device [cmdb_ci_ot_field_device]
• PLC [cmdb_ci_ot_plc]
• Printer [cmdb_ci_printer]
• RTU [cmdb_ci_ot_rtu]
• Serial Number [cmdb_serial_number]
• Server [cmdb_ci_server]
• Server [cmdb_ci_server]
• Solaris Server [cmdb_ci_solaris_server]
• Source [sys_object_source]
• Unix Servercmdb_ci_unix_server]
• Uninterruptible Power Supply (UPS) [cmdb_ci_ups]
• Wireless Access Point [cmdb_ci_wap_network]

For more information on where data is saved when pulling data from a Microsoft Defender for IoT (Azure) project, see CMDB classes targeted.

• Configure the Service Graph Connector for Microsoft Defender for IoT (Azure)
  Use the guided setup for the Service Graph Connector for Microsoft Defender for IoT (Azure) to lead you through the integration steps.
• Validate NIDS sensors
  Validate the Network IDS (NIDS) sensors once they're imported to prepare for the device import. Sensors only pass the validation if they aren't in learning mode as such sensors are not eligible for device import.
• Accessing the connection details of the Service Graph Connector for Microsoft Defender for IoT (Azure)
  You can access the connection details of the Service Graph Connector for Microsoft Defender for IoT (Azure) in a single view using the common connection framework (CCF) included within the Integration Commons for CMDB (sn_cmdb_int_util) store app.
• CMDB classes targeted in the Service Graph Connector for Microsoft Defender for IoT (Azure)
  When you complete the guided setup, you can configure the integration to periodically pull data from a Microsoft Defender for IoT (Azure) project. The data is saved in tables that extend from the Configuration item [cmdb_ci] table.
• Attribute mapping and classification for Service Graph Connector for Microsoft Defender for IoT (Azure)
  The following tables describe the attribute mapping and classification for sensors and devices.