Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Live Search
spaceKeyZenGRCOnboardingGuide
additionalnone
placeholderSearch our site
typepage

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 Beta | Connect.



  2. Add the link to your ServiceNow instance in the ServiceNow instance URL.
  3. Click Next.
    Select Username and password or OAuth2. This selection determines the next documentation section.

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 ServiceNow Connector 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

Instructions to come.

  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 
Info
titleNOTE

Continue to Creating a ServiceNow-Managed Audit.