Set up ServiceNow for Integration

Set up ServiceNow for integration with IoT Security through Cortex XSOAR.
The following are prerequisites for setting up ServiceNow for integration with IoT Security:
  • A configured ServiceNow instance with administrative access
  • A ServiceNow user account that XSOAR will use to form a secure connection with the ServiceNow instance and send it device attributes, alerts, and vulnerabilities
  • Your ServiceNow URL
When configuring the ServiceNow instance on XSOAR, you will be prompted to enter the username and password of the ServiceNow user account and the ServiceNow URL.
On your ServiceNow instance, you must set up two tables, one to receive device records and another to receive incidents from IoT Security. For ServiceNow to receive device records from XSOAR, you can either modify an existing table or create a new one. For it to receive security incidents, you must create a new table in ServiceNow.
ServiceNow configuration instructions are based on Newyork build, 11-04-2020_1502.
  1. Create a ServiceNow table for receiving device records from IoT Security.
    If you are creating a new table, do step 1.1. If you are editing an existing table, go to step 1.2.
    1. To create a table in ServiceNow for receiving device records from IoT Security, filter the navigation menu by entering
      System Definition
      in the Filter navigator field, click
      Tables
      New
      , and then enter the following:
      Label
      :
      Zingbox discovered devices
      Name
      : The name field autofills, automatically prepending
      u_
      , converting any uppercase characters to lowercase, and converting spaces and dashes to underscores to connect words. It automatically converts
      Zingbox discovered devices
      in the Label field to
      u_zingbox_discovered_devices
      in the Name field.
      Zingbox discovered devices
      is the default label and
      u_zingbox_discovered_devices
      is the default name to which Cortex XSOAR sends device records. If you use any another table with a different label, you must change the ServiceNow Discovered IoT Device Table Name in the two Cortex XSOAR jobs that send device records to this table: PANW IoT Bulk Export To Servicenow and PANW IoT ServiceNow Integration. For example, if you enter
      IoT Security discovered devices
      for the label in ServiceNow, which automatically generates
      u_iot_security_discovered_devices
      as the table name, then enter
      u_iot_security_discovered_devices
      in the two ServiceNow jobs in Cortex XSOAR
      Extends table
      : Your new table must extend the
      cmdb_ci
      configuration Item. Search for
      cmdb_ci
      and choose it from the list.
    2. Add the following custom column labels to the table so that ServiceNow can receive inventory updates from IoT Security and populate these table columns with data:
      The following are default column labels. If you use another cmdb device table with different column labels, you must change the corresponding default values in the two Cortex XSOAR jobs that send data to this table. The column labels are case sensitive. For example,
      category
      is different from
      Category
      .
      category
      profile
      iot_tag
      iot_vendor
      iot_model
      iot_os
      iot_ssid
      iot_site
      iot_vlan
      iot_wired_wireless
      os_support
    3. When done, click
      Submit
      .
    4. After adding the custom column labels, the table will consist of predefined and custom columns. To display a smaller set of relevant columns, click the
      Zingbox discovered devices
      label on the Tables page, scroll down past the table and click
      Show List
      in the Related Links section, and then click the
      Personalize List
      icon ( ). Use the left and right arrows to move column labels so that only the ones you want to see are in the Selected pane and then click
      OK
      .
  2. Create a ServiceNow table for receiving security incidents from IoT Security.
    1. From the ServiceNow Tables page, click
      New
      and enter the following:
      Label
      : Enter
      Zingbox alerts vulnerability incident
      .
      Name
      : The name field autofills, automatically prepending
      u_
      , converting any uppercase characters to lowercase, and converting spaces and dashes to underscores to connect words. It converts
      Zingbox alerts vulnerability incident
      in the Label field to
      u_zingbox_alerts_vulnerability_incident
      in the Name field.
      Extends table
      : Your new table must extend the
      Task
      configuration Item. Choose
      Task
      from the list.
    2. When done, click
      Submit
      .
  3. Add custom table columns to the table.
    1. Return to the table configuration page to edit it.
      The table consists of a set of predefined table columns. You will add two custom column labels to let ServiceNow receive comments from IoT Security about security incidents and provide links to the Security Alert Details and Vulnerability Details pages.
    2. Click
      New
      at the top of the table on the Columns tab.
      In the Dictionary Entry form that appears, enter the following and then click
      Submit
      :
      Type
      :
      String
      Column label
      :
      Comments
      Column name
      :
      u_comments
      (automatically fills based on the label)
      Max length
      :
      4,000
      (characters)
    3. To add the next column label, click
      New
      again, enter the following, and click
      Submit
      :
      Type
      :
      URL
      Column label
      :
      Security incident
      Column name
      :
      u_security_incident
      (automatically fills)
    4. Because ServiceNow displays a large set of columns, it’s useful to reduce the number to those of interest. To do this, click the
      Zingbox alerts vulnerability incident
      label on the Tables page, scroll down past the table and click
      Show List
      in the Related Links section, and then click the
      Update Personalized List
      icon ( ). Use the left and right arrows to move column labels so that only the following are in the Selected pane and then click
      OK
      .
  4. Create a ServiceNow user account for XSOAR to use when connecting to ServiceNow and sending it device attributes, alerts, and vulnerabilities.
    1. Navigate to
      System Security
      Users
      , click
      New
      , enter a user ID and password, and make sure the
      Password needs reset
      check box is cleared. Leave the other fields empty and click
      Submit
      .
      Remember the user ID and password because you will enter these later when configuring the ServiceNow instance in XSOAR.
    2. On the Users page, click the user ID of the account you just created to return to the account settings.
    3. To add roles to the user account, scroll down the page, click the
      Roles
      tab, and then click
      Edit
      . Search for the following four roles one by one and add them to the Roles List:
      rest_api_explorer
      u_zingbox_alerts_vulnerability_incident_user
      u_zingbox_discovered_devices_user
      web_service_admin
      If you use an existing device table whose label is not “Zingbox discovered devices”, the third role shown above will be a different name.
    4. Click
      Save
      to add the roles to the user account.
    5. On the user account settings page, click
      Update
      to save the updated settings.
    This completes the ServiceNow setup.

Recommended For You