ServiceNow CMDB
  • 4 Minutes to read
  • PDF

ServiceNow CMDB

  • PDF

About this document


This document gives you the step-by-step procedure to configure ServiceNow CMDB in SAFE.

Introduction


SAFE integrates with the ServiceNow CMDB (Configuration Management Database) via REST APIs and updates the assets in SAFE. This reduces the need for managing assets on SAFE separately.

A SAFE Admin can configure the ServiceNow CMDB from Administration > SAFE hooks > Management Tools.


Prerequisites


To configure ServiceNow CMDB in SAFE, you need the following details:

  • Instance Name: Instance name of the user’s ServiceNow Instance (E.G: safe.service-now.com)
  • Credentials: The minimum access required for the user account on ServiceNow should be cmdb_read
  • Client ID and Secret Key: Follow the below steps in Servicenow to get the ID and Secret Key”
    1. Go to System Oauth> Application Registry.

    2. Create a new OAuth client type or click on any of the existing CLients listed.


    3. Copy the Client ID and Client Secret Key from the respective fields.

Mapping for ServiceNow CMDB assets to SAFE


On import, SAFE maps each ServiceNow Configuration item (CI) to a Technology vertical in SAFE. Different ServiceNow CI classes require different sets of mandatory fields for SAFE to map the CI correctly to an Asset Type. If any mandatory field is not populated, then the corresponding CI will be fetched as an Unconfirmed Asset. The list of mandatory fields against each ServiceNow CI class is described in the table below.

Note
The SAFE-ServiceNow CMDB integration imports all assets independent of the asset state.
SAFE VerticalSAFE Asset TypeClasses in ServiceNowMandatory Fields
DatabasesOracle <version>cmdb_ci_db_ora_instance

Name 

Version 

IP Address


MS SQL <version>cmdb_ci_db_mssql_instance
MySQL <version>cmdb_ci_db_mysql_instance
MongoDB <version>cmdb_ci_db_mongodb_instance
PostgresSQL <version>cmdb_ci_db_postgresql_instance
IBM Db2 <version>cmdb_ci_db_db2_instance
SAP HANA Database <version>cmdb_ci_appl_sap_hana_db

Databases Network & Security Nodes

See SAFE Support Matrix for supported asset types - SAFE Support Matrixcmdb_ci_ip_firewall

Name

Manufacturer

Version

IP Address

See SAFE Support Matrix for supported asset types - SAFE Support Matrixcmdb_ci_ip_router
See SAFE Support Matrix for supported asset types - SAFE Support Matrixcmdb_ci_ip_switch
F5 Big Ipcmdb_ci_lb_bigip

Name

Version

IP Address

End Points or Server

Note - Asset type will be mapped to the Technology Vertical on the Operating System

See SAFE Support Matrix for supported asset types - SAFE Support Matrixcmdb_ci_computer

Name

OS

OS Version

Web Applications

Note: Java and ASP.NET are the only asset types supported.

JAVAcmdb_ci_app_server_java

Name

IP Address with the URL of the application or a custom field with the CI’s URL. If the custom field is present then update the environment variableSERVICENOW_WEB_APPLICATION_URL_FIELD to the custom field name in .env file.

ASP.NETcmdb_ci_appl_dot_net
MiddlewareSee SAFE Support Matrix for supported asset types - SAFE Support Matrixcmdb_ci_app_server_tomcat

Name

Model number

See SAFE Support Matrix for supported asset types - SAFE Support Matrixcmdb_ci_app_server_websphere

Name

Model number

See SAFE Support Matrix for supported asset types - SAFE Support Matrixcmdb_ci_microsoft_iis_web_server

Name

Model number

See SAFE Support Matrix for supported asset types - SAFE Support Matrix
The manufacturer is required to determine between Domain and stand-alone servers
cmdb_ci_app_server_jboss

Name

Manufacturer

Model number

Required Mapping Information


Please complete the following tables for each CI Class the organization would like to map to a SAFE technology vertical.

The supported  Asset Types by SAFE can be found at SAFE Support Matrix

End Points and Server

End Points and Servers are mapped by the combination of their CI Class, Operating System, and Operating System version to SAFE Asset Types and Technology Verticals.

Complete the following table to map the values of your ServiceNow CI cmdb_ci_computer class Operating System and Versions to SAFE Endpoint or Server Asset Types. Please provide all of the CI versions for a given CI Operating System.

ServiceNow CI Operating SystemServiceNow CI Version
Example
Windows7, 10
Windows Server2008, 08
Windows Server08, 8
Windows Server2008, 8

Network & Security Nodes

Network & Security Nodes are mapped by the combination of their CI Class, Manufacturer, and their version to SAFE Asset Types and Technology Vertical.

Complete the following table to map your ServiceNow CI Class, Manufacturer, and Versions to SAFE Database Asset Types. Please provide all of the CI versions for a given CI Manufacturer.

ServiceNow CI ClassServiceNow CI ManufacturerServiceNow CI Version
Example
cmdb_ci_ip_firewallCheckpoint76, 77
cmdb_ci_ip_firewallFortinet4, 5
cmdb_ci_ip_switchCisco12, 15
Note
For cmdb_ci_lb_bigip a CI Manufacturer is not required.

Web Applications

Web Applications are mapped by the combination of their CI Class and their version to SAFE Asset Types and Technology Vertical. The ServiceNow Web Application CI Class to SAFE Asset Type mappings are described in Table above.

All Web Applications that are contained in cmdb_ci_app_server_java will be mapped to the “JAVA” asset type.

All Web Applications that are contained in cmdb_ci_appl_dot_net will be mapped to the “ASP.NET” asset type.

Databases

Databases are mapped by the combination of their CI Class and their version to SAFE Asset Types and Technology Vertical. The ServiceNow Database CI Class to SAFE Asset Type mappings are described in Table above.

Complete the following table to map your ServiceNow CI Class and Versions to SAFE Database Asset Types. Please provide all versions for the given CI Class.

ServiceNow CI Class
ServiceNow CI “Versions” values
Example
cmdb_ci_db_ora_instance
19c, 19

Configure ServiceNow CMDB


SAFE Admin can configure the ServiceNow CMDB from Safe Hooks. To configure:

  1. Navigate to the Administration > Safe Hooks > Management Tools.
  2. Click the Configure button available on the ServiceNow CMDB option. The system opens the ServiceNow CMDB Configuration page.

    ServiceNow CMDB Configuration

  3. Enter the Instance Name.
  4. Enter the Username and Password.
  5. Enter the Client ID and Client Secret Key.
  6. Enter the Auto-Sync Frequency.
  7. Click the Test Connection button.
  8. Once the connection is verified, click the Save button to save the configuration.

    ServiceNow CMDB 1(1)

  9. To sync the assets once the connection is verified, click the Sync Now button available at the bottom-right corner of the screen.

    Sync CMDB(1)

Was this article helpful?

What's Next