ServiceNow

Supported version: Cloud up to Tokyo.

API Rate Limit: No limit.

Supported Authentication:

Basic authentication

To configure ServiceNow to use basic authentication, follow the steps below:-

  1. Enter your ServiceNow for example ServiceNow
  2. Select “Create New Account” and add user friendly name for account “ServiceNow Account”
  3. Enter your username and password
  4. Click on “Connection”

IMPORTANT: Please make sure your ServiceNow instance must be accessible from the Gathr Analytics Machine.

OAuth 2.0 Authentication

Follow the below steps to register an OAuth 2.0 application on ServiceNow using your account. You may need admin privileges to perform below steps.

  1. Login into your ServiceNow Account.
  2. Using ‘Filter navigator’, go-to for System OAuth → Application Registry. Then click on NEW button.
  3. Choose ‘Create an OAuth API endpoint for external clients’
  4. Enter following details in the available forms.

A. Name: Gathr Analytics Application (or any user friendly name) B. Client Secret: Enter any complicated string of length up-to 10 characters. C. Redirect URL: This would be https://<HostName.DomainName>:48444/AccountMa nagementWebService/callback.html

For example: If Gathr Analytics is installed on machine whose hostname is KleraMachine.Klera.io then Redirect URL would be https://KleraMachine.Klera.io:48444/AccountManagementWebService/callback.html

Important:

  • This URL should be accessible from the client machine. Machine from where user is login into Gathr Analytics.
  • Need to add port 48444 in Firewall/Security systems whitelist.
  1. Click on Submit button after entering above details. This will redirect to the list of all application. Click again on the newly added application to see its details.

On the detail page, copy and save

  1. Client ID
  2. Client Secret.

We will need these information while importing connector on Gathr Analytics.

Perform below steps on Gathr Analytics. User should have access to “Connectors”.

After login into Gathr Analytics, perform below steps:

  1. Right click on the floor, go-to Connectors → Import.

  2. Import the ServiceNow Connector.zip file.

  3. After successful import, this will result in a new container contains name of data source “REST Connections”.

  4. Right click on the entity of column “ServiceNow Connector” and go-to Connectors → Connections → Configure.

  5. Enter following details in the opened form:

  6. Instance URL: Instance URL of your ServiceNow instance. For example : https://dev60488.service-now.com

  7. Application Key: Enter Client ID.

  8. Application Secret: Enter Client Secret.

  9. Authorization URL: ServiceNow

  10. Access Token URL: ServiceNow

  11. Domain for Callback: Enter Hostname with domain of Gathr Analytics For example: Gathr AnalyticsMachine.Gathr Analytics.io

    Now click on Submit button.

Doing above process, a form will open-up which will prompt for ServiceNow credentials and after successful authentication, it will redirect to the Call Back URL(redirect URL) mentioned in the ServiceNow.

Doing Above process successfully, ServiceNow Connector is imported successfully and user can execute operations using Connectors → All Connectors → ServiceNow.

This Connector requires following access to following tables:

AccessTable NamesEntity Names
Read OnlyincidentIncident
Read Only, itilchange_requestChange Request
Read Only, catalog_adminsc_requestRequest
Read Onlycore_companyCompanies
Read Only, itilproblemProblem
Read Onlysys_userUser
Read Onlycmdb_ci_serviceBusiness Services
Read Onlycontract_slaSLA Definition
Read Onlycmn_locationLocation
Read Onlysys_history_lineWorklogs
Read Onlytask_slaSLA Information
Read Onlysys_user_groupAssignment Groups
Top