Page Comparison

Overview

After completing the first part of integration by following Installing the ZenGRC Application in ServiceNow, you can connect the applications within ZenGRC. This documentation explains how to configure ZenGRC to access the information in your ServiceNow application.If you are an Enterprise customer and would like to activate the ServiceNow Settings link in your instance, please contact us at support@reciprocitylabs.com.

If your company is using the self-hosted, on-premise version of ServiceNow, then inbound/outbound traffic must be allowed through your firewall through whitelisting IP addresses. For additional information, please review IP Whitelisting.

Requirements

For information regarding ServiceNow technical requirements, please see the information at ServiceNow Connector - Beta prior to these steps.

Setting the Connection

---

DI:NOTE - How to access connectorsAfter accessing the ServiceNow connector in your instance by following Introduction to ZenConnect, complete the following these steps to set up the connection:

1. On the ServiceNow Settings page, add Click ServiceNow | Connect.
   
   Image Added
   
   
2. Add the link to your ServiceNow instance in the ServiceNow instance URL.
3. Click Next.Image Removed
   The displayed page shows two ways to connect to ServiceNow as shown by the below screenshot. Only one needs to be completed for the configuration to work. The two ways are described in the next sections, and are as follows:
4. Using OAuth2.
Using a ServiceNow username and password.
Image Removed

Using OAuth2

OAuth2 provides a secure connection between ZenGRC and ServiceNow, but it includes additional set up time.

Using Username and Password

Image Removed

Configuring ServiceNow

Using Username and Password

1. If you haven't already done so, create a service-level API user account in ServiceNow with the minimum required permissions specified in Installing the ZenGRC Application in ServiceNow
2. Select Username and password or OAuth2. This selection determines the next documentation section.
3. Enter the username and password for the ServiceNow service-level API user account into the respective text boxes.
   
   Image Added
   
   
4. Click Connect.

Using OAuth2

1. Select the 0Auth2 radio button. The following screen appears.
   Image Added
2. Click ServiceNow System OAuth > Application registry to open ServiceNow's 0Auth2 application registry  screen in a new tab.
   Image Added
3. Returning to the ZenGRC tab, copy-and-paste each of the provided values into the following fields within ServiceNow's 0Auth2 application registry screen:

   1. Name

   2. Redirect URL 

   3. Refresh token lifespan

   4. Access token lifespan

4. In ServiceNow's 0Auth2 application registry screen, click Submit. ServiceNow will display a list of connected applications.
5. From that list, reopen the ZenGRC application to find its Client ID and Client Secret 
   Image Added
6. Return to the ZenGRC tab, and copy-and-paste the Client ID and Client Secret values into the corresponding fields, and click Connect.
7. You will be redirected to a ServiceNow screen asking you to confirm the connection. Click Allow 
   Image Added
8. Assuming everything worked, ZenGRC should show that the connection is active. You can test the connection at any time using the "Test Connection" option from the Actions drop-down.
   Image Added