- Print
- DarkLight
ServiceNow Policy Exception is a formal authorization to deviate from an established policy within the platform. These exceptions are typically granted when there is a legitimate business need that justifies the deviation from standard procedures or security policies.
Platform Compatibility
This integration has been successfully tested for compatibility with ServiceNow version Utah.
Integration Capabilities
To connect DataBee and ServiceNow Policy Exception to build your organization hierarchy, DataBee needs to connect to an API endpoint that retrieves a list of request items. This API endpoint as well as its example response is shown below
Setup and Configure
The scope is a mechanism to let an application request limited access to a user’s data. ServiceNow platform supports authentication scopes to allow admins to limit access of an OAuth client application to a specific REST API.
Prerequisite Role required: choose the admin role for Create an OAuth API endpoint for external clients.
Navigate to System OAuth > Application Registry and then click New. On the "interceptor" page, click Create an OAuth API endpoint for external clients and then fill in the form.
Name | Unique Name that identifies the application |
Client ID | This will be auto-generated by the instance (to be provided to DataBee) |
Client Secret | This will be auto-generated by the instance (to be provided to DataBee) |
Refresh Token Lifespan | 8,640,000 seconds (100 days) & can be increased |
Access Token Lifespan | 1800 seconds (30 Minutes) & can be increased |
For OAuth, the 'grant type' will be Password credentials, the 'scope' will be useraccount and the 'token URL' will be https://instance.service-now.com/oauth_token.do.
Prerequisite Role for 'create user': user_admin
Create a user in the User table and make sure the 'Time Zone' field is set to UTC to get the UTC date in the API. This user should be active, not locked out so that instance can produce an access token for OAuth.
For example:
User ID | rest.user |
Password | rest.user |
Web service access only | true |
API Reference
Table API
The Table API provides endpoints that allow you to perform create, read, update, and delete (CRUD) operations on existing tables. E.g. Request Item class: using the sc_req_item table we can retrieve the request items.
The calling user must have sufficient roles to access the data in the table specified in the request.
REQUEST PARAMETERS
To show the actual value instead of the IDs of the fields, the below query parameter is required.
sysparm_display_value=true
REQUEST
Retrieves multiple records for the specified table.
URL format
Default URL: /api/now/table/{tableName}?sysparm_display_value=true
E.g.: /api/now/table/sc_req_item?sysparm_display_value=true
RESPONSE
Integration Source and Data Format
Source of data: API
Data format: JSON