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:-
- Enter your ServiceNow for example ServiceNow
- Select “Create New Account” and add user friendly name for account “ServiceNow Account”
- Enter your username and password
- 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.
- Login into your ServiceNow Account.
- Using ‘Filter navigator’, go-to for System OAuth → Application Registry. Then click on NEW button.
- Choose ‘Create an OAuth API endpoint for external clients’
- 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.
- 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
- Client ID
- 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:
Right click on the floor, go-to Connectors → Import.
Import the ServiceNow Connector.zip file.
After successful import, this will result in a new container contains name of data source “REST Connections”.
Right click on the entity of column “ServiceNow Connector” and go-to Connectors → Connections → Configure.
Enter following details in the opened form:
Instance URL: Instance URL of your ServiceNow instance. For example : https://dev60488.service-now.com
Application Key: Enter Client ID.
Application Secret: Enter Client Secret.
Authorization URL: ServiceNow
Access Token URL: ServiceNow
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:
Access | Table Names | Entity Names |
---|---|---|
Read Only | incident | Incident |
Read Only, itil | change_request | Change Request |
Read Only, catalog_admin | sc_request | Request |
Read Only | core_company | Companies |
Read Only, itil | problem | Problem |
Read Only | sys_user | User |
Read Only | cmdb_ci_service | Business Services |
Read Only | contract_sla | SLA Definition |
Read Only | cmn_location | Location |
Read Only | sys_history_line | Worklogs |
Read Only | task_sla | SLA Information |
Read Only | sys_user_group | Assignment Groups |
If you have any feedback on Gathr documentation, please email us!