--- title: Configure the Service Graph Connector Integration for Claroty CTD description: Use the guided setup for Service Graph Connector Integration for Claroty CTD to lead you through the integration steps. locale: en-US canonical_url: https://www.servicenow.com/docs/r/australia/operational-technology/operational-technology-manager/configuring-sgc-claroty-ctd-guided-setup.html release: australia product: Operational Technology Manager classification: operational-technology-manager topic_type: task last_updated: "2026-03-12" reading_time_minutes: 14 breadcrumb: [Service Graph Connector Integration for Claroty CTD, Integrate, Operational Technology Manager, Operational Technology] --- # Configure the Service Graph Connector Integration for Claroty CTD Use the guided setup for Service Graph Connector Integration for Claroty CTD to lead you through the integration steps. ## Before you begin Dependencies and requirements: - The [Integration Commons for CMDB](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/servicenow-platform/integration-commons-for-cmdb.md) store app, which is automatically installed. - The [CMDB CI Class Models app](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/servicenow-platform/cmdb-ci-class-models.md), which is automatically installed. - The ITOM Discovery License plugin \(com.snc.itom.discovery.license\). You must activate this plugin. - ITOM Licensing plugin \(com.snc.itom.license\). For more information, see [Request Discovery](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/it-operations-management/t_ActivateTheDiscoveryPlugin.md). - The Datastream Action plugin \(com.glide.hub.action\_type.datastream\), which is automatically installed. - Review that **View** access is enabled in Claroty CTD for the following user permissions to collect data from Claroty CTD to ServiceNow: - Visibility - Investigation - The Industrial Core plugin. You must activate this plugin. The Industrial Core plugin is required to access the class mappings table for the Service Graph Connector Integration for Claroty CTD. For more information about the Industrial Core plugin, see [Industrial Core plugin](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/operational-technology/operational-technology-manager/industrial-core-plugin.md). Role required: admin **Note:** If you have an earlier version of the Service Graph Connector Integration for Claroty CTD, then don’t migrate data from the old connector. You must uninstall the previous version and run the new integration. ## Procedure 1. Ensure that the application is set to Service Graph Connector Integration for Claroty CTD by using the application picker. For more information, see [Application picker](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/application-development/c_ApplicationPicker.md). 2. Navigate to **All** > **Service Graph Connector Claroty CTD** > **Guided Setup**. 3. On the Getting started page, select **Get Started**. 4. To configure a MID Server, complete the following: 1. In the Setup Connections and Credentials section, select the Configure MID server task. 2. Select **Mark as complete** once you complete the MID Server configuration. 5. To set up the connections records, complete the following: 1. In the Setup Connections and Credentials section, select the Configure Connections task. 2. Select **Configure**. 3. Open the Claroty CTD API record in the Connections table. 4. In the **Connection URL** field, enter the name of the URL for your Claroty CTD Enterprise Management Console \(EMC\). For example, [https://192.168.1.100](https://192.168.1.100). 5. If you're using a MID Server, select the **Use MID Server** check box in the record. **Note:** If you're not using a MID Server, go to step 5g. 6. From the Advanced MID Server Configuration related list, select a MID Server and a MID Selection. 7. Select **Update**. 8. Repeat steps 5a to 5h to update the **Claroty CTD EMC Base Auth** record. 6. To set up the credentials records, complete the following: 1. In the Setup Connections and Credentials section, select the Configure Credentials task. 2. Select **Configure**. 3. Open the Claroty CTD EMC Base Auth record in the Credentials table. 4. In the **User name** field, enter the user name that you used to log in to the Claroty CTD EMC. 5. In the **Password** field, enter the password that you used to log in to the Claroty CTD EMC. 6. Select **Update**. 7. To test the connection, complete the following: 1. In the Setup Connections and Credentials section, select the Test/Validate Connection task. 2. Select the **Test Connection** UI action from the related links section on the data source record for sensors. After completing the connection test, view the results. You must perform the suggested troubleshooting steps until the test result returns **Success**. 3. Check that the connection manager has a valid certificate. A valid certificate must be installed for a production environment. For a non-production or proof of concept \(POC\) instance, you can configure the system properties to enable the integration to work when the connection manager doesn’t have a valid certificate. The following table lists the system properties that you can configure for a non-production environment.
| Property | Value |
|---|---|
| com.glide.communications.httpclient.verify\_hostname | Set to **false**. |
| com.glide.communications.httpclient.verify\_revoked\_certificate | Set to **false**.If you need to add this system property, see [Add a system property](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-administration/t_AddAPropertyUsingSysPropsList.md). |
| com.glide.communications.trustmanager\_trust\_all | Set to **true**. |
| Property | Description |
|---|---|
| sn\_clarotyctdsgc.resourcepath.site | Property to set the resource path for the sites: **Note:** The resource path for the sites is provided by default for the Claroty CTD Enterprise Management Console \(EMC\) V4.4.3 API version for the CTD sites and devices. If you want to use a different API version, you can override the paths. |
| sn\_clarotyctdsgc.resourcepath.device | Property to set the resource path for the devices: **Note:** The resource path for the devices is provided by default for the CTD EMC V4.4.3 API version for the CTD sites and devices. If you want to use a different API version, you can override the paths. |
| sn\_clarotyctdsgc.pagesize.device | Property to set the number of device records to fetch in a paginated REST call to the Claroty CTD EMC. The default value is 500 records per page. **Note:** 500 is the maximum number of devices per page. |
| sn\_clarotyctdsgc.resourcepath.baseline | Property to set the resource path for the baselines: **Note:** The resource path for the baselines is provided by default for the CTD EMC V4.4.3 API version for the CTD sites and devices. If you want to use a different API version, you can override the paths. |
| sn\_clarotyctdsgc.pagesize.baseline | Property to set the number of baseline records to fetch in a paginated REST call to the Claroty CTD EMC. The default value is 500 records per page. |
| sn\_clarotyctdsgc.get\_all\_baselines | Property to fetch all records for baselines or only the new records since the start time of the last successful import. **Note:** When you import baselines for the first time, all records are imported regardless of the setting for this property. |
| sn\_clarotyctdsgc.resourcepath.entity | Property to set the resource path for the entities: **Note:** The resource path for the entities is provided by default for the CTD EMC V4.4.3 API version for the CTD sites and devices. If you want to use a different API version, you can override the paths. |
| sn\_clarotyctdsgc.resourcepath.program | Property to set the resource path for the installed programs: **Note:** The resource path for the installed programs is provided by default for the CTD EMC V4.4.3 API version for the CTD sites and devices. If you want to use a different API version, you can override the paths. |
| sn\_clarotyctdsgc.pagesize.entity | Property to set the number of entity records to fetch in a paginated REST call to the Claroty CTD EMC. The default value is 500 records per page. |
| sn\_clarotyctdsgc.pagesize.program | Property to set the number of program records to fetch in a paginated REST call to the Claroty CTD EMC. The default value is 500 records per page. |
| sn\_clarotyctdsgc.api\_token\_life\_in\_minutes | Property to set the number of minutes that the API is considered active. After the time expires, the Service Graph Connector fetches a new API key during the next import. The default value is 0 and a new token is fetched for each REST call. **Note:** You can change the value to keep the same token for a maximum of 24 hours and reduce the number of REST calls. |
| sn\_clarotyctdsgc.classify\_based\_on\_os | Property to provide a list of classes that support the classification by OS as part of the Service Graph Connector Integration for Claroty CTD. When the flag is set to **True**, the classification by OS is supported. When it is set to **False**, the Service Graph Connector no longer classifies by OS. For example: ``` { "cmdb_ci_ip_switch":true, "cmdb_ci_nids":false } ``` |
| sn\_clarotyctdsgc.filter.asset\_type\_code | Property to provide a list of codes for device types separated by the delimiter \($\).For more information about Claroty types and codes, see [CMDB classes targeted](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/operational-technology/operational-technology-manager/sgc-claroty-ctd-classes.md). For example, to only import PLC and HMI device types, enter the Claroty type code as `0$1`. |
| sn\_clarotyctdsgc.filter.asset\_purdue\_level | Property to provide a list of Purdue Levels separated by the delimiter \($\). For example, to only filter devices with Purdue Levels 1 and 2, To only filter Devices with Purdue Level 1 & 2, set the value as `1.0$2.0`. |
| Action | Description |
|---|---|
| Enter a conditional script | Enter a conditional script that determines whether a scheduled import should run by selecting **Conditional**. |
| Change the default import schedule | Change the default import schedule by setting the **Run** field as necessary. |
| Reference a user in the Users table | Reference a user in the Users table by selecting a user in the **Runs as** field. **Note:** By default, this field is set to System Administrator. The selected user must be assigned the admin role for the import to be successful. If left empty, the import schedule uses the roles of the logged-in user. |
| Run an import | Run an import by selecting Execute Now. You can import either all records or only new records since the start time of the last successful import, based on the system properties configured. For more information, see [Configure guided setup](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/operational-technology/operational-technology-manager/configuring-sgc-claroty-ctd-guided-setup.md). |
| Activate the import | Activate the import by selecting the **Active** check box. |
| Save any schedule changes | Save any schedule changes by selecting **Update**. |
| Action | Description |
|---|---|
| Enter a conditional script | Enter a conditional script that determines whether a scheduled import should run by selecting **Conditional**. |
| Change the default import schedule | Change the default import schedule by setting the **Run** field as necessary. |
| Reference a user in the Users table | Reference a user in the Users table by selecting a user in the **Runs as** field. **Note:** By default, this field is set to System Administrator. The selected user must be assigned the admin role for the import to be successful. If left empty, the import schedule uses the roles of the logged-in user. |
| Run an import | Run an import by selecting Execute Now. You can import either all records or only new records since the start time of the last successful import, based on the system properties configured. For more information, see [Configure guided setup](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/operational-technology/operational-technology-manager/configuring-sgc-claroty-ctd-guided-setup.md). |
| Activate the import | Activate the import by selecting the **Active** check box. |
| Save any schedule changes | Save any schedule changes by selecting **Update**. |
| Action | Description |
|---|---|
| Enter a conditional script | Enter a conditional script that determines whether a scheduled import should run by selecting **Conditional**. |
| Change the default import schedule | Change the default import schedule by setting the **Run** field as necessary. |
| Reference a user in the Users table | Reference a user in the Users table by selecting a user in the **Runs as** field. **Note:** By default, this field is set to System Administrator. The selected user must be assigned the admin role for the import to be successful. If left empty, the import schedule uses the roles of the logged-in user. |
| Run an import | Run an import by selecting Execute Now. You can import either all records or only new records since the start time of the last successful import, based on the system properties configured. For more information, see [Configure guided setup](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/operational-technology/operational-technology-manager/configuring-sgc-claroty-ctd-guided-setup.md). |
| Activate the import | Activate the import by selecting the **Active** check box. |
| Save any schedule changes | Save any schedule changes by selecting **Update**. |
| Action | Description |
|---|---|
| Enter a conditional script | Change the default import schedule by setting the **Run** field as necessary. |
| Change the default import schedule | Change the default import schedule by setting the **Run** field as necessary. |
| Reference a user in the Users table | Reference a user in the Users table by selecting a user in the **Runs as** field. **Note:** By default, this field is set to System Administrator. The selected user must be assigned the admin role for the import to be successful. If left empty, the import schedule uses the roles of the logged-in user. |
| Run an import | Run an import by selecting Execute Now. You can import either all records or only new records since the start time of the last successful import, based on the system properties configured. For more information, see step 7c. |
| Activate the import | Activate the import by selecting the **Active** check box. |
| Save any schedule changes | Save any schedule changes by selecting **Update**. |