ServiceNow

This document describes the procedure for configuring the ServiceNow connector to retrieve information via the ServiceNow API.

Objective

The purpose of this connector is to provide a method for retrieving information from ServiceNow using either Basic Authentication or OAuth2.

Prerequisites

• Access to a ServiceNow environment with administrator permissions
• ServiceNow REST API enabled

Procedure

Create an Integration User

1. Access ServiceNow:
   • Log in to your ServiceNow environment with an Administrator account.
2. Create a new user:
   • Use the Filter Navigator to search sys_user.
   • Click New to create a new user.
3. Configure the user:
   • Enter a username and password.
   • Set the user to "Active".
   • Click Save.
4. Assign roles to the user:
   • Assign the following roles for API access:
     • rest_api_explorer
     • rest_service
   • Add any additional roles needed for your use case.
   • Click Save.

Configure OAuth2 (Recommended)

1. For OAuth2 authentication:
   • Use the Filter Navigator to search System OAuth.
   • Go to Application Registry > New.
2. Create an OAuth application:
   • Choose Create an OAuth API endpoint for external clients.
   • Fill in the application name.
   • Retrieve the Client ID.
   • Generate a Client Secret.
   • Restrict access to the required scope (CMDB).
   • Click Save.

Configure in OverSOC

1. In OverSOC, go to Data Sources Settings > Sources.
2. Select ServiceNow and click Configure.
3. Enter the ServiceNow tenant URL.
4. Choose authentication method:
   • OAuth 2.0 (recommended): Enter Client ID and Client Secret
   • Basic Auth: Enter username and password
5. Click Save Configuration.

Official Documentation

For more information, see the ServiceNow API Authentication Guide