Integrating with ServiceNow to Create Data Mapping Automation Assets

You can integrate a ServiceNow account with OneTrust to create assets in the Data Mapping Automation module. This integration allows you to sync your inventory with assets that you would like to update.

To set up credentials in OneTrust

This documentation uses Basic Authentication to create an integration credential. For more information on ServiceNow's authentication methods, see ServiceNow REST API product documentation.

For more information on creating integration credentials, see Configuring Integration Credentials.

  1. On the Integrations menu, click Credentials.

    The Credentials screen appears.

  2. Click the Add New button.

    The Add Credential modal appears.

  3. Create a new Basic credential using your ServiceNow account information. For more information, see Add Credential Modal Reference .
  4. Click the Add button.

Add Credential Modal Reference



Field
Description
Credential Name

Enter a name to identify the credential.

Description

Enter a description of the credential.

System

Select ServiceNow as the system.

Credential Type

Select Custom as the credential type.

Connector Type

Select HTTP as the connector type.

Auth Type

Select Basic as the authorization type.

Test URL

Enter a test URL for the new credential.

Protocol

Enter HTTPS as the protocol for the credential.

Hostname

Enter the hostname for the credential.

Default Headers (Optional)

Select the type of key which should be used in the header of the call made by the connection.

You can add additional keys if your credential requires more than one header.

Username & Password

Enter your username and password.

To import the workflow

Attached to this article is a JSON template you can import into OneTrust to create the ServiceNow workflow. For more information on importing workflow templates, see Customizing Integration Workflows.

  1. On the Integrations menu, click Connections.

    The Connections screen appears.

  2. Click the Import button.

    The Import modal appears.

  3. Complete the fields. For more information, see Import Modal Reference .
  4. Click the Add button.

    The Workflow Builder screen appears.

Import Modal Reference



Field
Description
Import Type

Select Workflow: Create.

Workflow Name

Enter a name for the ServiceNow workflow.

Upload File

Click the Upload File button to upload the JSON template attached to this article.

To configure the workflow

Once you've created the workflow via template import, you will need to further configure the workflow with your new credentials, parameter values, and a trigger schedule.

Note:

The GET AssetDiscovery step pulls assets from the alm_asset table in ServiceNow. You can change this as necessary by inputting a different table name after table/ in the URL. If you do, you will also have to edit the body in the PUT Upsert Inventory step.

Inventory Configuration

Note:

This integration is configured to update the asset inventory, but it can be changed to update other inventories by editing the Type parameter.

  1. Click the Edit icon on the PUT Upsert Inventory step.
  2. Enter the Organization ID and Organization Value of the organizational level at which you would like the inventory records to be created.


  3. Enter the Location ID and Location Value of the country at which you would like your inventory records to be created.


  4. Click the Finish button.

Trigger Frequency

  1. Click the Edit icon on the Schedule Trigger step.
  2. Select the Frequency and Time of Day at which you would like this integration to run.


  3. Click the Done button.
  4. Click the Save button.
  5. Click the Activate button.
    Note:

    Clicking Activate will turn on the integration to run at the specified freqency. You will have to select Deactivate to turn off the scheduled frequency.

To configure the workflow trigger in Zendesk

  1. From the Admin menu, navigate to Settings > Business Rules > Triggers.
  2. Click the Add trigger button. Configure the trigger.
    Field
    Description
    Trigger name

    Enter a name to describe the trigger.

    Conditions

    Select the conditions to meet all or any criteria for when the ticket is created. This may include sending email notifications when tickets are created or updated, or when the requestor updates information.

  3. Locate the Actions section, then select Notify Target.
  4. Select the HTTP target you configured in the previous section.
  5. Edit the provided payload as necessary.
    Note:

    The payload is configured using liquid markup language to meet OneTrust API acceptance criteria.

  6. Click the Create button.

Updating Credentials

  1. Click the Edit icon on the GET AssetDiscovery step.
  2. Click the Edit icon next to Account Credentials.
  3. Select your ServiceNow Credentials.


  4. Click the Next button.
  5. Click the Finish button.