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 allow you to send Sevco findings about your Device assets back to your instance of ServiceNow as an incident ticket.

How Does the Integration Work

When a user creates an Incident in Sevco, it is sent to their instance of ServiceNow via API. From there, ServiceNow processes the data and generates a functional Incident ticket with the provided details.

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.
- Send Incident Ticket
  No additional configuration options needed
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
- itil
- sn_incident_write
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.