Netskope Help

Configure ServiceNow for API Data Protection

Note

Netskope has now validated support up till ServiceNow Quebec release for API Data Protection.

To configure ServiceNow for API Data Protection, you need to authorize Netskope as a web application client to access your ServiceNow instance.

There are two parts to this procedure:

  • Configure ServiceNow API access.

  • Configure a ServiceNow instance in the Netskope UI

Configure ServiceNow API Access

To configure the ServiceNow API endpoint:

  1. Log in to your ServiceNow account as an admin user.

  2. On the left navigation, filter by System OAuth and click Application Registry.

  3. Click New to create a new application registry.

    ServiceNowNewAppReg.jpg
  4. Click Create an OAuth API endpoint for external clients.

    ServiceNowNewAppEndpoint.jpg
  5. Enter a name and client secret. The client ID is auto generated. Note down the client secret and ID; you will need these to create the ServiceNow instance in the Netskope UI.

    ServiceNowClientID.jpg

    Note

    The refresh token lifespan default value is 100 days. After that, the token will not be valid, and data will not be accessible. Enter a large refresh token lifespan to ensure accessibility.

  6. When finished, click Submit.

Important

If there are any records with invalid dates (for example, a future date) in the problem table, ensure that you delete such records. To delete a problem record, read the ServiceNow article. This step is essential so that Netskope receives problem events successfully.

Configure a ServiceNow Instance in the Netskope UI

Make sure you don't have any ACL/IP ACL, business rules, or data policy constraints before setting up the instance.

The ServiceNow administrator should have access to the following tables and roles:

Table 3. ServiceNow Tables and Roles

Table

Role

Usage

Incident

ITIL

Access records from the Incident table.

Problem

ITIL

Access records from the Problem table.

sys_db_object

ITIL

Get Incident and Problem table records.



Though the incident, problem, and sys_db_object tables require the ITIL role, it is recommended to give the admin role to all the three tables so that API Data Protection can access the delete notifications from ServiceNow.

To authorize Netskope to access your ServiceNow instance:

  1. Log in to the Netskope tenant UI: https://<tenant hostname>.goskope.com and go to Settings > API-enabled Protection > SaaS.

  2. Select the ServiceNow icon, and then click Setup Instance.

  3. The Setup Instance window opens. Enter the following details:

    • Enter the name of the ServiceNow account instance.

      Note

      If your ServiceNow login URL is https://my_instance.service-now.com/, then enter my_instance as the instance name.

    • Instance Type: Select the following check box:

      • API Data Protection: Select this option to allow Netskope to scan through your SaaS app instance to list files, user, and other enterprise data.

      • Security Posture: Select this option to allow Netskope to continuously scan through your SaaS app to identify and remediate risky SaaS app misconfigurations and align security posture with best practices and compliance standards.

        Note

        This feature is part of the Netskope SaaS Security Posture Management solution. For additional configuration requirement, read Netskope SaaS Security Posture Management.

    • Enter the email address of the ServiceNow administrator.

      Note

      • To identify the email address of the ServiceNow administrator account, log in to your ServiceNow account, navigate to User Administration > Users. Click the administrator user and note down the email address.

      • Netskope does not support SAML-based SSO for ServiceNow. The ServiceNow administrator email address must be a local user.

  4. Click Save, then click Grant Access for the app instance you just created. You will be prompted to enter the following details:

    • ServiceNow Admin - Enter the user ID of the ServiceNow administrator.

      Note

      To identify the user ID of the ServiceNow administrator account, log in to your ServiceNow account, navigate to User Administration > Users. Click the administrator user and note down the user ID.

    • ServiceNow Password - Enter the password of the ServiceNow administrator.

    • Enter Client ID - Enter the client ID you noted when you configured the ServiceNow API access.

    • Enter Client Secret - Enter the client secret you noted when you configured the ServiceNow API access.

    Click Grant. When the configuration results page open, click Close.

Refresh your browser and you will see a green check icon next to the instance name.