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 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 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. Click ServiceNow Beta | Connect.
   
   
   
   
2. Add the link to your ServiceNow instance in the ServiceNow instance URL.
3. Click Next.

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.

2. Enter a ServiceNow administrative the username and password for the ServiceNow service-level API user account into the respective text boxes.
   
   
   
   
3. 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