ServiceNow

Source Connector

Overview

Persona

This source connector queries the ServiceNow Table API

Streams

  • Application Server (cmdb_ci_app_server)
  • Base Configuration Item (cmdb)
  • Change Request
  • Change Task
  • CI Relationship (cmdb_rel_ci)
  • Configuration Item (cmdb_ci)
  • Database Instance (cmdb_ci_db_instance)
  • Event (em_event)
  • Group (sys_user_group)
  • Incident
  • Infrastructure Service (cmdb_ci_infra_service)
  • Location (cmn_location)
  • Problem
  • Server (cmdb_ci_server)
  • Service (cmdb_ci_service)
  • Sys Audit
  • Sys_audit_delete
  • Sys_choice
  • Sysevent
  • Syslog_transaction
  • User (sys_user)
  • Virtual Machine HyperVisor (cmdb_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

The source connector is restricted by rate limits.