Overview

ServiceNow CMDB is a database that stores information about assets and services. It enables a variety of powerful workflows for managing and automating your IT and security controls.

Why You Should Integrate

Integrating with ServiceNow CMDB will provide visibility into the assets that are currently in the ServiceNow CMDB as well as enrich existing Sevco assets with additional details defined within the CMDB.

How Does the Integration Work

This integration pulls configuration items (CIs) from the cmdb_ci_hardware table of the ServiceNow CMDB.

This data is only used internally; we do not share it with any parties outside of Sevco. Refer to our privacy policy for details.

Configuration

Configure the Access Schema

Field	Description	Example
`URL`*	The URL used to access the source	`https://api.product.com`
`Username`*	The username used to identify the authorization and permissions	`ABCDEF0123456789`
`Password`*	The password used to authenticate with the source	`***********************`

Add an Integration: Select the integration(s) you'd like to add.
- Collect Devices
  Configuration Options

Field	Description	Example
`Domains`	Comma separated list of domains/company names to include in data pull	`sevco.io`
`Filter deleted assets`	Excludes deleted assets (`install_status = 7`) from data pull	N/A

Configure General Information: OPTIONAL: You can use the following fields to provide additional information about your configuration.

Field	Description	Example
'Name (optional)'	Uniquely identifiable attribute of the configuration to delineate other similar configurations with the existing organization.	'DMZ network'
'Contact Person (optional)'	A placeholder to input a name or email address of a contact associated with the integration.	'Jane Doe'
`Link to Console (optional)'	A placeholder to input a link to the console of the product Sevco is integrating with for quick reference and access when configuring or editing the integration.	'www.product.com/devices'

Activate Config: To enable this configuration select "Activate".

External Documentation

Creating credentials

You'll be asked to provide source credentials that Sevco will use to connect to ServiceNow CMDB. The following link will step you through creating an account. ServiceNow Documentation - Create User

Note: To limit that user to only API access or Non-Interactive Sessions check the Web service access only check box when configuring the user.

Required Permissions

The following roles or permissions are required:

Choose one Base System Role:
- admin
- cmdb_read Note: Currently testing for least privilege

Assign all Custom Roles:
- rest_api_explorer
- web_service_admin

To edit an existing role follow the instruction in ServiceNow documentation - Add a role to an existing role

Note: Additional details are being investigated to assist in clarifying permissions assignment and supporting least privilege access.

API Documentation

ServiceNow APIs and scripts

Contact Us

If you're having problems integrating a source, or if you've found something wrong in this document, please email us at [email protected] or suggest edits directly by selecting the Suggest Edits located in the upper right hand corner of the documentation.