Connect to ServiceNow

Overview

To integrate Finout with your ServiceNow instance, designate a user account that Finout will use to make API calls on your behalf. This ensures smooth and secure communication between Finout and your ServiceNow instance.

Note:

You need administrator-level access to your ServiceNow instance. This access is required to configure the user for the integration and to create an OAuth application within your ServiceNow instance, which is essential for the integration.

ServiceNow Configuration Workflow:

1. Choose a User

2. OAuth Authentication

3. Add ServiceNow credentials to Finout

1. Choose a User for the Integration

1. In ServiceNow, create or use a dedicated user with the appropriate ACL permission to read incident metadata fields and create incidents. The user should have the following read ACL permissions:

   1. sys_db_object

   2. sys_db_object.*

   3. sys_dictionary

   4. sys_dictionary.*

   5. sys_glide_object

2. OAuth Authentication

To enable your instance to receive inbound calls from our service, create an OAuth application within your instance to initiate a token exchange process. Follow these steps to set it up:

1. Navigate to System OAuth > Application Registry.
2. Click New and then click Create an OAuth API endpoint for external clients.
3. Fill in the following fields:

   1. Name: <ANY>

   2. Client Type: Integration as a service

      Note: Make sure to leave the Redirect URL and Logo URL empty.

      
4. Press Submit. You will be redirected to the list of all available apps.

5. Navigate to the app that you created and press the lock icon next to the Client Secret field. This will reveal the Client secret, which you will need to provide to Finout later.

   
6. In Finout, fill in the following information:

   1. ServiceNow Instance URL

   2. ServiceNow Client ID

   3. ServiceNow Client Secret

   4. ServiceNow User Name

   5. ServiceNow User Password

Note: The username and password should belong to the dedicated user created for the integration.

3. ServiceNow Configuration in Finout

1. In Finout, navigate to Settings > Integrations.

   Note: You can connect with only one instance.

   
2. Click Add Integration.

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

   

   1. Enter your ServiceNow Instance URL.

   2. Enter the Client ID from the ServiceNow OAuth application.

   3. Enter the Client secret associated with the ServiceNow OAuth application.

   4. Enter the ServiceNow User name for Authentication.

      Note: The user should have the following read ACL permissions:

      1. sys_db_object

      2. sys_db_object.*

      3. sys_dictionary

      4. sys_dictionary.*

      5. sys_glide_object

   5. Enter the password for the specified ServiceNow user.

4. 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.

What happens if the integration is deleted? It will be deleted along with all associated ServiceNow endpoints.

Why are no fields available for selection in the “Additional Fields” dropdown when creating an endpoint?

The integration user lacks authorization and requires the following read ACL permissions:

• sys_db_object

• sys_db_object.*

• sys_dictionary

• sys_dictionary.*

• sys_glide_object