What is ServiceNow? #
ServiceNow is a software company that provides a cloud-based, AI-driven platform for automating multiple management workflows in enterprises. ServiceNow provides IT service management, IT operations management (ITOM), and IT business management (ITBM).
Why Should You Use the ServiceNow Connector? #
The ServiceNow connector provides visibility into the assets in your environment. You can use this visibility to:
-
ensure assets are managed per your security policies
-
derive relationships between assets, users, applications, and data
How Does This Connector Work? #
Lucidum executes read-only requests to the ServiceNow REST API and ingests only meta-data about ServiceNow devices. Lucidum does not retrieve any data stored on your assets.
Configuring the Connector in Lucidum #
| Field | Description | Example |
| URL | The URL for the ServiceNow server. | https://lucidum1.service-now.com |
| Data Lookback in Days | Number of previous days to ingest data for. | 3 |
| Other Tables | ServiceNow CMDB tables to fetch data from. | IP switch table, router table, application table or database table |
| Core Tables | Core ServiceNow CMDB tables to fetch data from. | computer table, server table, or hardware table |
| Username | User name for a ServiceNow account with the roles itil, rest_api_explorer, web_service_admin | tonystark |
| Password | Password for a ServiceNow account with the roles itil, rest_api_explorer, web_service_admin | IAmIronMan2008 |
| User Table Filter | Filter to apply to the ServiceNow users table (sys_user_table) to retrieve only users who match the filter.
Use the ServiceNow to create the encoded query. For details, see https://developer.servicenow.com/dev.do#!/learn/learning-plans/washingtondc/servicenow_application_developer/app_store_learnv2_rest_washingtondc_more_about_query_parameters For example, to retrieve only users with a valid value in the department column, you could enter: &sysparm_query=department!=” |
&sysparm_query=department!=” |
Adding Values to the Other Tables field and Core Tables field #
To add a table to the Other Tables field or Core Tables field:
- Put your cursor in the Other Tables or Core Tables field.
- Enter the name of the table.
- Press Enter.
- A new chip with the table name appears in the field.
Source Documentation #
Creating Credentials #
To create a user in ServiceNow for the Lucidum connector to use:
Before configuring the ServiceNow connector in Lucidum, you must first create a user with read permissions for all ServiceNow assets. Lucidum will use that account to access ServiceNow.
To create a user in ServiceNow:
-
As an administrator, log into the ServiceNow admin panel and go to the User Administration panel.
-
Click “Users” and then “New”. Fill in the details for this user.
-
Create the user and then search for it in the users screen, to configure it. Click “Edit” to edit the user’s attached roles.
-
Assign the “itil”, “rest_api_explorer”, “web_service_admin” roles and then click “Save” and finally “Update” to save the user.
To generate a OAuth client ID and Oauth client secret for your ServiceNow instance:
Required Permissions #
When creating a user for the Lucidum connector, assign these roles to the user.
|
Object |
Permissions |
|---|---|
|
Role |
itil |
|
Role |
rest_api_explorer |
|
Role |
web_service_admin |
API Documentation #
https://developer.servicenow.com/dev.do#!/reference/api/utah/rest/
