ServiceNow

About this document

This document provides step-by-step instructions to onboard a ServiceNow account in SAFE.

Introduction

SAFE integrates with ServiceNow via read-only APIs and fetches the security configuration of the ServiceNow account in SAFE.

Prerequisites

To configure ServiceNow in SAFE, you need the following details:

• Instance Name: Instance name of the user’s ServiceNow Instance (e.g., safe.service-now.com)

• Client ID and Secret Key: To generate a Client ID and Secret Key, you must have a ServiceNow Administrator role.

Generate Connection Details (Client ID and Secret Key)

1. Log in to your ServiceNow Account as admin. 

2. Click the All tab, and search for System OAuth > Application Registry.
    

3. Click the Application Registry option.

4. Click the New button available at the top-right corner of the screen.
    

5. On the New page, click the “Create an OAuth API endpoint for external clients” option.
    

6. Enter a Name for the application and click the submit button. The system creates a new app.

7. Go to the created app details page.

8. Copy the Client ID and Client Secret.
    

Configure ServiceNow in SAFE

1. Navigate to Safe Hooks and click the ServiceNow card.

2. Enter the Instance Name.

3. Enter the Username and Password (Admin Username and Password for ServiceNow account)

4. Enter the Client ID and Client Secret Key.

5. Enter auto-sync frequency in days.

6. Click the Test Connection button.

7. Once the connection is validated, click the Save button

8. Once the configuration is saved, click the Sync Now button to trigger the on-demand sync outside of the scheduled auto sync.

View Results

After a successful sync, SAFE automatically pulls the ServiceNow assets.

To view the assets pulled from ServiceNow:

1. On the ServiceNow configuration page, click the See Updated Assets option available at the top-right of the History table.

2. The system redirects you to a filtered asset list.

FAQ

What permissions does SAFE require to assess the configuration of ServiceNow?

The following minimum permissions are required on the below sys_properties records: