Review and configure integration settings
To make the Service Graph Connector for ServiceNow OT Discovery simple to use, set options that let you modify the integration behavior to meet your business needs.
Before you begin
Be sure to complete all previous configurations for the Service Graph Connector for ServiceNow OT Discovery before beginning the following tasks.
Role required: admin
About this task
Configure the ServiceNow OT Discovery Classification Settings which define how ServiceNow OT Discovery categories are mapped to target CMDB classes. Configure additional settings based on Classification such as the CI naming strategy and if you permit OS classification. Default recommended classification settings are provided by the application which you can then configure for your needs.
Procedure
Select Configure classification settings.
- Next to the Configure classification settings task, select Configure.
Review the default OT Discovery Classification Settings.
Note: The OT Discovery Classification Settings define how OT Discovery categories are mapped to the target ServiceNow Instance CMDB classes. It also defines how they are configured to additional settings based on classification, such as the configuration item (CI) naming strategy and whether to permit OS classification. The default recommended classification settings are provided by the application, which you can then configure for your needs.
All the devices that are imported follow a default naming strategy.
- You have the flexibility at a class level to change the name.
- You can map the Target CMDG Class name to an OT Device type and can change the mapping settings.
- If any changes are needed, open the OT Discovery Classification Setting record and update the entries in the following fields.
| Field | Description |
|---|---|
| Active | If checked, the Classification Setting is used when classifying the devices. If unchecked, the Classification Setting is ignored. |
| Source Class | The class name of the source asset. |
| Network type | Defines whether this classification setting is for OT or IT devices only. Leave empty to include both types.If OT devices with a specific category must be classified into a separate class from IT devices, there are two definitions for the OT Discovery Category. One definition has the Network type set to OT with the classification for the OT devices. The other definition is set to IT for classifying the IT devices. |
| Target CMDB class | The CMDB class to target when importing the OT Discovery device. |
| OT device type | For OT devices, you can select the OT device type to apply the device type to the imported OT Discovery asset in the CMDB, if applicable. |
Next, Configure system properties.
- Next to the Configure system properties task, select Configure.
Configure Systems properties
2. The Configure System properties window opens.
3. Review the System properties and adjust as needed for your instance configuration.
| System property | Description |
|---|---|
| \(Optional\) Comma-separated list of OT Discovery categories to filter the Asset imports. | Filters the Asset import to only import assets of particular categories. For example, if you wanted to only import ICS Host and PLC category devices from the Discovery Console for OT, you could set this to Note: These are categories defined on the Console side. |
| API Page Size | Maximum number of rows to be returned from a single REST call. Default: 500 |
| API Max Timeout | Maximum amount of time to wait for a response when making REST calls to OT Discovery.Default: 30000 |
| Load Raw API Data into Staging Table | When set to true, the raw API data for each row is included in the staging tables along with the parsed data. This is useful when trying to compare data imported data into ServiceNow vs. what is available in the OT Discovery API. |
| Log Levels | Logging level verbosity to use for the application.Default: Info |
4. Select **Save** and close the window.
5. Return to the Configure system properties task and select **Mark as complete**.
6. Return to the Guided Setup page.
What to do next
The next setup step is toSet up scheduled import jobs.