Introduction

This article describes the Field Effect MDR integration with SericeNow. This article covers the following:

• Integration Details
  • Requirements 
• Setting up the Integration
  • Prepare ServiceNow for the Integration
• Complete the Integration in the MDR Portal

Integration Details

If your organization uses ServiceNow, this integration allows Field Effect MDR monitoring access to your ServiceNow environment, enriching its monitoring fidelity.

To learn more about ServiceNow integrations, visit their support documentation.

Requirements 

To complete this integration, you will need administrator access to both your ServiceNow environment and the Field Effect MDR Portal.

Setting up the Integration

To complete this integration, you will need to perform the following procedures:  

1. Prepare Service Now for the Integration:
   1. Create an OAuth API endpoint within ServiceNow.
      • Some of the information provided in this process will need to be provided in the MDR Portal.
2. Complete the Integration in the MDR Portal:
   1. Provide the information you saved while preparing ServiceNow for the integration (Host Name, Client ID, Client Secret)

An admin account is required to set up this integration, and additional information can be found in the ServiceNow documentation.

Prepare ServiceNow for the Integration

Additional information can be found in the ServiceNow documentation.

Create an OAuth API Endpoint

Log into your ServiceNow instance and search for "Application Registry" in the sidebar’s menu filter. Click the Application Registry result.

Click New in the upper right corner to add the new application for Field Effect MDR to the Application Registry. 

You will be asked what type of application to make. Select Create an OAuth API endpoint for external clients. 

Fill out the following for the new API endpoint: 

• Give your API Endpoint a Name (Field Effect MDR). 
• Set the Redirect URL to the following link https://ionic.fieldeffect.net/servicenow/callback/

When ready, click Submit.

Your new application will now be listed in the registry. Click on it to see more details. 

Save the following pieces of information about your new application and ServiceNow instance, as you will need them in the next procedure:

• Client ID: Found on the New API endpoint form
• Client Secret: Found on the New API endpoint form.
• Host Name: If you don’t know the hostname, it can be found in the address bar on this page (ie: your-organization.service-now.com). 

Complete the Integration in the MDR Portal

Note for Partners: This procedure is performed on a per-client basis. Ensure that the Organization Selector is set to the appropriate client before continuing.

From the Integrations page's (Administration section) Cloud Monitoring tab, click Add in the Service Now card.

A window will open providing you with the instructions for the procedure above (Creating an API Endpoint). Complete the procedure and click Next.

Provide the Hostname, Client ID, and Client Secret in the next window and click Submit.

You’ll be redirected to a new page asking to connect your ServiceNow account with Field Effect. Click Allow to continue.

You'll be taken back to the integrations page, and the integration card will show that the integration is connected and promoted to the top, alongside any other connected integrations.