Connect to ServiceNow

Overview

Integrating ServiceNow with Finout allows you to create ServiceNow incidents for anomalies directly from the Finout platform. This integration simplifies issue tracking and resolution.

ServiceNow Configuration Workflow:

1. Create an API Key

2. Set Up Inbound Authentication Profile

3. Configure REST API Access Policies

4. Add ServiceNow credentials to Finout

Prerequisites:

You need administrator-level access to your ServiceNow instance. This access is required to configure API keys, authentication profiles, and API access policies, which are essential for the integration.

1. Create an API Key

An API Key is a secure token to authenticate Finout with your ServiceNow instance.

1. Sign into ServiceNow and navigate to the All tab.

2. In the ServiceNow search bar, type "REST API Key" and select it from the results. You are brought to the API Keys page.

   
3. Click New to create a new API Key. The API Key creation page appears.

   
4. Fill in the onscreen fields.

   Note: The role of the user selected in the User field must have Read access to all tables referenced during incident creation, as well as the following tables:

   • sys_db_object

   • sys_db_object.*

   • sys_dictionary

   • sys_dictionary.*

   • sys_glide_object

5. Click Submit. You are redirected to the API keys list.

   
6. Click on the newly created API key to view its details. The API Key page appears.

   
7. Click to reveal and copy the API key.

2. Set Up Inbound Authentication Profiles

Authentication Profiles define how the API key is used to authenticate requests.

1. In ServiceNow, navigate to the All tab.
2. In the search bar, type "Inbound Authentication Profile" and select it from the results. You are brought to the Authentication Profile page.

   
3. Click New. The Authentication Profile page appears.

   
4. Select Create API Key Authentication Profile and fill in the on-screen fields The API Key Authentication Profile appears.

   
5. Fill in the on-screen fields:

   1. Add a name

   2. Add a Auth Parameter

   3. Select the Auth Parameter.

6. Click Submit. The profile is saved.

3. Configure REST API Access Policies

REST API Access Policies define the permissions and scope for the API key.

1. In ServiceNow, navigate to the All tab.
2. In the search bar, type "REST API Access Policies" and select it from the results. You are brought to the API Access Policies page.

   
3. Click New to create a new access profile. The API Access Policies Profile appears.

   
4. Fill in the on-screen fields:

   1. Add a name

   2. Select a REST API

   3. Select a REST API PATH

   4. Ensure that all these checkboxes are marked - Active, Apply to all methods, Apply to all resources, and Apply to all versions.

   5. Select the API key created in Step 1.

5. Click Submit. The REST API configuration is complete.

4. ServiceNow Configuration in Finout

1. In Finout, navigate to Settings > Integrations.

   Note: You can connect with only one instance.

   
2. Under ServiceNow, click Connect Now. The ServiceNow Integration wizard appears.

   
3. Add your ServiceNow Instance URL and API token, and then click Connect.

   ServiceNow is now connected.

Next Step: Create a Service Now endpoint. See ServiceNow Incident Endpoint.

FAQs

How many ServiceNow instances can I connect?

Only one ServiceNow instance.

Can I use the integration if I don't create endpoints?

No, you must have endpoints configured to use the ServiceNow integration.