ServiceNow
Source Connector
Overview
This source connector queries the ServiceNow Table API
Streams
| Data Source | Stream Name |
|---|---|
| Application Server | cmdb_ci_app_server |
| Base Configuration Item | cmdb |
| Change Request | change_request |
| Change Task | 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 | incident |
| Infrastructure Service | cmdb_ci_infra_service |
| Location | cmn_location |
| Problem | problem |
| Server | cmdb_ci_server |
| Service | cmdb_ci_service |
| Sys Audit | sys_audit |
| Sys_audit_delete | sys_audit_delete |
| Sys_choice | sys_choice |
| Sysevent | sys_event |
| Syslog_transaction | syslog_transaction |
| User | sys_user |
| Virtual Machine HyperVisor | cmdb_ci_vm |
Prerequisites
- Login to your ServiceNow instance.
- Navigate to Users
- Go to the "System Security" section and select "Users".
- Create a New User:
- Click the New button.
- Fill in the necessary details.
- Ensure to select the checkboxes for Web service access only and Active.
- Click the Submit button to create the user.
- Locate the New User:
- Find the newly created user in the users list.
- Click on the User ID to open the user record details.
- Assign Roles:
- In the user record details, a new "Roles" tab will appear at the bottom.
- Click on "Edit" under the Roles tab, which will open a new page with all available roles.
- 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.
- Save the changes.
- Set Password:
- Return to the user record.
- You will see a "Set Password" button next to the update and delete buttons.
- Click the Set Password button, which will open a popup.
- Click the Generate button inside the popup to create a password, then click Save Password.
- Instance Name
- 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.
- OAuth (optional):
- If Tarsal should use OAuth authentication, follow the steps mentioned in the documentation under the Procedure section.
- It is important to have security_admin role. Follow this servicenow video for more guidance.
Configuration
| Field | Required | Description | Example |
|---|---|---|---|
| Instance Name | yes | Instance name found in URL of your ServiceNow instance | dev12345 |
| Username | yes | Your ServiceNow account username. | account123 |
| Password | yes | Your ServiceNow account password. | password123 |
Connector Limitations
- When first configured, the connector will load the last 24 hours of logs.
- This connector is restricted by rate limits.
Updated 9 months ago