ServiceNow

Source Connector

Overview

Persona

This source connector queries the ServiceNow Table API

Streams

Data SourceStream Name
Application Servercmdb_ci_app_server
Base Configuration Itemcmdb
Change Requestchange_request
Change Taskchange_task
CI Relationshipcmdb_rel_ci
Configuration Itemcmdb_ci
Database Instancecmdb_ci_db_instance
Eventem_event
Groupsys_user_group
Incidentincident
Infrastructure Servicecmdb_ci_infra_service
Locationcmn_location
Problemproblem
Servercmdb_ci_server
Servicecmdb_ci_service
Sys Auditsys_audit
Sys_audit_deletesys_audit_delete
Sys_choicesys_choice
Syseventsys_event
Syslog_transactionsyslog_transaction
Usersys_user
Virtual Machine HyperVisorcmdb_ci_vm

Prerequisites

  1. Login to your ServiceNow instance.
  2. Navigate to Users
    1. Go to the "System Security" section and select "Users".
  3. Create a New User:
    1. Click the New button.
    2. Fill in the necessary details.
    3. Ensure to select the checkboxes for Web service access only and Active.
    4. Click the Submit button to create the user.
  4. Locate the New User:
    1. Find the newly created user in the users list.
    2. Click on the User ID to open the user record details.
  5. Assign Roles:
    1. In the user record details, a new "Roles" tab will appear at the bottom.
    2. Click on "Edit" under the Roles tab, which will open a new page with all available roles.
    3. For the Table API, Tarsal supports 21 different streams. You can either add all admin roles for each stream or simply add the general "admin" role.
    4. Save the changes.
  6. Set Password:
    1. Return to the user record.
    2. You will see a "Set Password" button next to the update and delete buttons.
    3. Click the Set Password button, which will open a popup.
    4. Click the Generate button inside the popup to create a password, then click Save Password.
  7. Instance Name
    1. Note the name of the ServiceNow instance for use in later steps. For example, if the URL to your ServiceNow instance is https://dev12345.service-now.com, then the instance name is dev12345.
  8. OAuth (optional):
    1. If Tarsal should use OAuth authentication, follow the steps mentioned in the documentation under the Procedure section.
    2. It is important to have security_admin role. Follow this servicenow video for more guidance.

Configuration

FieldRequiredDescriptionExample
Instance NameyesInstance name found in URL of your ServiceNow instancedev12345
UsernameyesYour ServiceNow account username.account123
PasswordyesYour ServiceNow account password.password123

Connector Limitations

  1. When first configured, the connector will load the last 24 hours of logs.
  2. This connector is restricted by rate limits.