Configuring ZenGRC with ServiceNow

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.

Requirements

For information regarding ServiceNow technical requirements, please see ServiceNow Connector prior to these steps.

Setting the Connection

After accessing the ServiceNow connector in your instance by following Introduction to ZenConnect, complete these steps to set up the connection:

1. Click ServiceNow | 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.
3. Enter the username and password for the ServiceNow service-level API user account into the respective text boxes.
   
   
   
   
4. Click Connect.

Using OAuth2

1. Select the 0Auth2 radio button. The following screen appears.
   
2. Click ServiceNow System OAuth > Application registry to open ServiceNow's 0Auth2 application registry  screen in a new tab.
   
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 
   
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 
   
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.