ServiceNow
Configure the ServiceNow connector to retrieve information via the ServiceNow API
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
- Access ServiceNow:
- Log in to your ServiceNow environment with an Administrator account.
- Create a new user:
- Use the Filter Navigator to search sys_user.
- Click New to create a new user.
- Configure the user:
- Enter a username and password.
- Set the user to "Active".
- Click Save.
- Assign roles to the user:
- Assign the following roles for API access:
rest_api_explorerrest_service
- Add any additional roles needed for your use case.
- Click Save.
- Assign the following roles for API access:
Configure OAuth2 (Recommended)
- For OAuth2 authentication:
- Use the Filter Navigator to search System OAuth.
- Go to Application Registry > New.
- 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 OverView
- In OverView, go to Data Sources Settings > Sources.
- Select ServiceNow and click Configure.
- Enter the ServiceNow tenant URL.
- Choose authentication method:
- OAuth 2.0 (recommended): Enter Client ID and Client Secret
- Basic Auth: Enter username and password
- Click Save Configuration.
Alternative: file import through DropPoint
The API access described above is the recommended method for this connector. Where it is not available (a segregated network, a version or licence without API, an export you already produce), OverView accepts file exports, to be uploaded to the bucket dedicated to ServiceNow.
Bucket : s3://servicenow/
Example : s3://servicenow/export.csv
The procedure is described in the OverView DropPoint guide: generating credentials, configuring the client, then sending files from the OverView web interface, the AWS CLI or an SDK. Its examples come pre-filled with this bucket when you follow this link.
Official Documentation
For more information, see the ServiceNow API Authentication Guide