{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":49102,"path":"servicenow-platform/service-graph-connectors/configure-extrahop-integration.md","title":"Configure Service Graph Connector for ExtraHop","bundle":null,"doc_type":null,"release":"australia","body":"\n# Configure Service Graph Connector for ExtraHop\n\nSet up a REST message and scheduled jobs to import ExtraHop data into your CMDB.\n\n## Before you begin\n\n**Important:** ServiceNow hosted Service Graph Connector for ExtraHop is now deprecated and no longer supported or available for new activation. ExtraHop hosted Service Graph Connector for ExtraHop provides the latest experience for this functionality. For details, see the [Deprecation Process \\[KB0867184\\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB0867184) article in the Now Support Knowledge Base.\n\nTo use this Service Graph Connector, you need a subscription to a Subscription Unit that is based in the IT Operations Management \\(ITOM\\) Visibility application or in the ITOM Discovery application. As defined in the section titled \"Managed IT Resource Types\" in [ServiceNow Subscription Unit Overview](https://www.servicenow.com/products/entitlements-packages.html) for your subscription, for managed IT resources that are created or modified in the CMDB by this Service Graph Connector, but that aren’t yet managed by [ITOM Visibility or ITOM Discovery](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/it-operations-management/itom-license-module.md), these resources will increase Subscription Unit consumption from that application. Review your current Subscription Unit consumption within ITOM Visibility or ITOM Discovery to ensure available capacity.\n\nDependencies and requirements:\n\n- The [Integration Commons for CMDB](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/cmdb-integration-commons/integration-commons-for-cmdb.md) store app, which is automatically installed.\n- The CMDB CI class models store app, which is automatically installed. See [CMDB CI Class Models app](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/cmdb-ci-class-models/cmdb-ci-class-models.md).\n- 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).\n- ITOM Discovery License plugin \\(com.snc.itom.discovery.license\\). You must activate this plugin.\n- MID Server that is installed on Linux or Windows, unless the ExtraHop appliance is publicly accessible.\n- ExtraHop Discover appliance with firmware version 7.2 or later, with a user account that has unlimited privileges.\n- To connect to the ExtraHop application, configure an API key. For more information, see [ExtraHop REST API Guide](https://docs.extrahop.com/8.1/rest-api-guide/), specifically, see the \"ExtraHop API requirements\" section.\n\nRoles required: admin\n\n## Procedure\n\n1. Navigate to **All** > **Service Graph Connector ExtraHop** > **Setup**.\n\n2. On the Getting started page, click **Get Started**.\n\n3. On the Service Graph Connector for the ExtraHop page, in the Configure REST message section, select the task **Configure ExtraHop REST message**.\n\n4. Configure a REST message to use when sending requests to the ExtraHop API.\n\n 1. On the next page, in the Configure ExtraHop REST message task section, click **Configure**.\n\n 2. On the form, fill in the fields.\n\n\n
\n\nField\n\n\n\nDescription\n\n
\n\nName\n\n\n\nDescriptive name for this REST Message. This field is automatically set.\n\n
\n\nEndpoint\n\n\n\nURL to the web service API endpoint. Set the field to a base URL. For example, `https://myextrahop.com`. **Note:** Updating the Endpoint base URL also updates the base URLs for all HTTP methods that are associated with the ExtraHop REST message. In the **HTTP Request** tab, update the Authorization header to use your API key in the **Value** field.\n\n
\n\nDescription\n\n\n\nDescription for this REST Message. This field is automatically set.\n\n
\n\nApplication\n\n\n\nApplication that contains this message. The field is automatically set.\n\n
\n\nAuthentication type\n\n\n\nType of authentication to apply to HTTP requests. The field is automatically set.\n\n
\n\nUse mutual authentication\n\n\n\nOption to use multiple authentication by authenticating HTTP requests. Mutual authentication cannot be used with a MID Server.\n\n
3. Click **Update** if necessary.\n\n 4. In the Configure ExtraHop REST message task section, click **Mark as Complete**.\n\n5. Test the connection to the ExtraHop Computer API.\n\n 1. In the Test Computer connection task section, click **Configure**.\n\n 2. On the form, fill in the fields.\n\n |Field|Description|\n |:----|:----------|\n |Name|Unique identifier for this HTTP method. This field is automatically set.|\n |Endpoint|URL to the web service API endpoint|\n |Use MID Server|MID Server that sends this HTTP request. Using a MID Server is not compatible with mutual authentication.|\n |REST Message|REST message record that this method is based on. This field is automatically set.|\n |HTTP method|HTTP method that is implemented by this method. This field is automatically set.|\n |Application|Application that contains this method. This field is automatically set.|\n |Authentication type|Type of authentication to apply to HTTP requests.|\n |Use mutual authentication|Option to use multiple authentication by authenticating HTTP requests. Mutual authentication cannot be used with a MID Server.|\n\n 3. Select the **HTTP Request** tab and fill out the **Use MID Server** field.\n\n 4. Click the **Authentication** tab and then click the **Test** related link.\n\n Testing the connection takes a few moments. When the test is complete, the page is refreshed and shows the test results.\n\n 5. Select **Mark as Complete**.\n\n **Note:** The connection is successful if the **HTTP Status** field is set to **200**. If there are any errors in the **Error Message** field, then the connection failed and further troubleshooting is required.\n\n 6. Click **Update** if necessary.\n\n 7. In the Test Computer connection task section, click **Mark as Complete**.\n\n6. Test the connection to the ExtraHop Network Activity Create API.\n\n 1. In the Test Network Activity Create connection task section, click **Configure**.\n\n 2. On the form, fill in the fields.\n\n |Field|Description|\n |:----|:----------|\n |Name|Unique identifier for this HTTP method.|\n |Endpoint|URL to the web service API endpoint|\n |Use MID Server|MID Server that sends this HTTP request. Using a MID Server is not compatible with mutual authentication.|\n |REST Message|REST message that this method is based on. This field is automatically set.|\n |HTTP method|HTTP method that is implemented by this method. This field is automatically set.|\n |Application|Application that contains this record. This field is automatically set.|\n |Authentication type|Type of authentication to apply to HTTP requests. This field is automatically set.|\n |Use mutual authentication|Option to use multiple authentication by authenticating HTTP requests. Mutual authentication cannot be used with a MID Server.|\n\n 3. Click the **Authentication** tab and then click the **Test** related link.\n\n Testing the connection takes a few moments. When the test is complete, the page is refreshed and shows the test results.\n\n 4. Select **Mark as Complete**.\n\n **Note:** The connection is successful if the **HTTP Status** field is set to **200**. If there are any errors in the **Error Message** field, then the connection failed and further troubleshooting is required.\n\n 5. Click **Update** if necessary.\n\n 6. In the Test Network Activity Create connection task section, click **Mark as Complete**.\n\n7. Set up the scheduled import jobs.\n\n 1. On the Service Graph Connector for ExtraHop page, in the Set up scheduled import jobs section, select the task **Configure Computer scheduled job**.\n\n 2. In the Configure Computer scheduled job task section, click **Configure**.\n\n 3. On the form, fill in the fields.\n\n |Field|Description|\n |:----|:----------|\n |Name|Name of the scheduled job.|\n |Data source|Data source record that defines the data to import.|\n |Run as|Option to run the scheduled job with the credentials of the specified user.|\n |Active|Option to activate the scheduled job. Select this option.|\n |Concurrent Import|Function that loads the data from multiple import sets. The function then processes and transforms the data concurrently.|\n |Partition Method|Partition method for the concurrent import set.|\n |Partition Size|Import set size for early scheduling.|\n |Execute pre-import script|Option to specify a script to run before the import is performed.|\n |Execute post-import script|Option to specify a script to run after the import is performed.|\n |Application|Application that contains this scheduled job.|\n |Run|Frequency of running the import.|\n |Conditional|Conditions under which this job is executed.|\n\n 4. Click **Update** if necessary.\n\n 5. In the Configure Computer scheduled job task section, click **Mark as Complete**.\n\n8. Configure the Network Activity scheduled job.\n\n 1. On the Service Graph Connector for ExtraHop page, in the Set up scheduled import jobs section, select the task **Configure Network Activity scheduled job**.\n\n 2. In the Configure Network Activity scheduled job task section, click **Configure**.\n\n 3. On the form, fill in the fields.\n\n |Field|Description|\n |:----|:----------|\n |Name|Name of the scheduled job.|\n |Data source|Data source record that defines the data to import.|\n |Run as|Option to run the scheduled job with the credentials of the specified user.|\n |Active|Option to activate the scheduled job. Select this option.|\n |Concurrent Import|Function that loads the data from multiple import sets. The function then processes and transforms the data concurrently.|\n |Partition Method|Partition method for the concurrent import set.|\n |Partition Size|Import set size for early scheduling.|\n |Execute pre-import script|Option to specify a script to run before the import is performed.|\n |Execute post-import script|Option to specify a script to run after the import is performed.|\n |Application|Application that contains this scheduled job.|\n |Run|Frequency of running the import.|\n |Conditional|Conditions under which this job is executed.|\n\n 4. Click **Update** if necessary then **Mark as Complete**.\n\n\n"}}