ServiceNow CMDB Integration

General Information

Netreo can be configured to periodically scan (every 5 minutes) your ServiceNow CMDB for devices and automatically add any newly discovered devices as managed devices in Netreo.

When adding devices from ServiceNow, Netreo is able to retrieve the following device attributes from the CMDB to populate the relevant fields of the administrative view of each device's Device Dashboard before being processed by Netreo's onboarding system.

• IP address
• Manufacturer
• Name
• ServiceNow type
• Site location
• Vendor

Devices added to Netreo from a CMDB are organized into sites based on the location designator configured for those devices in ServiceNow.

Netreo creates a separate site for each member of that designator type that it finds and assigns any discovered devices appropriately. For example, if you select "City" as the designator Netreo will create a new site for each city it finds while discovering devices and assign those devices to them based on their City value.

Netreo recognizes all of the default ServiceNow designators, as well as any custom designators (configured in ServiceNow). If no designator is selected during filter creation, no new sites are created and all discovered CMDB devices are placed into the default Unknown site.

Add Devices From a ServiceNow CMDB

To configure Netreo to discover devices in your ServiceNow CMDB and automatically add them for monitoring, follow the steps below.

You must provide your ServiceNow CMDB account credentials while configuring ServiceNow in Netreo, so be sure to have them available. (If you are using a proxy server for communication between Netreo and ServiceNow, also have the access credentials for that server available.)

If you wish to use a custom location designator, please configure the designator in ServiceNow prior to adding your CMDB to Netreo.

Procedure

1. Log in to Netreo as a user with the SuperAdmin access level.
2. From the main menu, select Administration > Add Device > Learn from ServiceNow CMDB to navigate to the ServiceNow administration page.
3. If you wish Netreo to use a proxy server to process requests to ServiceNow (otherwise, skip to step 4):
   1. Locate the ServiceNow Proxy panel.
   2. In the IP ADDRESS field, enter the IP address of your proxy server.
   3. In the PORT field, enter the port to use for your proxy server.
   4. In the USERNAME field, enter the username to use to access your proxy server.
   5. In the PASSWORD field enter the password for the above username.
   6. Use the AUTHENTICATION drop-down to select the authentication type to use with your proxy server.
   7. Select Save Proxy Configuration.
4. Add your ServiceNow CMDB information to Netreo.
   1. Locate the ServiceNow Configuration panel.
   2. In the USERNAME field enter the username for your ServiceNow CMDB account.
   3. In the PASSWORD field enter the password for the username above.
   4. In the INSTANCE field enter the custom part of the URL (provided by ServiceNow) for accessing the CMDB.
   5. Use the LOCATION DESIGNATOR  drop-down to select the CMDB location designator  by which you wish to organize your discovered devices.
      • If no designator is selected, no new sites are created and all discovered CMDB devices are placed into the default "Unknown" site.
   6. Select Save.
   7. Select Test ServiceNow to check connectivity to your ServiceNow CMDB.
5. You must now configure at least one filter to discover devices in your CMDB. (Devices are discovered in the CMDB based on filter matches. So, if no filters are configured, no devices can be discovered.)
   1. Locate the Filters table.
   2. Select the "add filter" button (+).
      • Filters are evaluated using a logical OR when discovering devices. Devices matching any configured filter are added to Netreo.
   3. In the sys_class_name  field enter the sys_class_name of the devices you wish to add as it appears in the CMDB.
      • This field is required and is exact-match only.
   4. Optionally, in the name  field enter the device name of the devices you wish to add as it appears in the CMDB.
      • You may use a regex expression in this field, if desired.
   5. Optionally, in the vendor_name  field enter the vendor name of the devices you wish to add as it appears in the CMDB.
      • You may use a regex expression in this field, if desired.
   6. Optionally, in the manufacturer_name  field enter the manufacturer name of the devices you wish to add as it appears in the CMDB.
      • You may use a regex expression in this field, if desired.
   7. In the Active Device Parameters  fields enter the key/value pair configured in the CMDB for the devices you wish to add.
      • This field is required and is exact-match only.
      • Enter the key in the first field, and the value in the second field.
      • Inclusion parameters are evaluated using a logical AND when discovering devices. A device must match all parameters included in the filter to be added to Netreo.
   8. Optionally, in the Inclusion parameter  fields enter an additional active device parameter.
      • These fields are merely additional active device parameter fields and follow the same rules indicated above.
   9. Optionally, if you wish to add additional active device parameters to the filter, select the plus (+) button to add another set of Inclusion parameter fields.
   10. Select Save to save your filter.
6. Optionally, repeat steps 5a - 5j to add and configure additional filters as required.

Once you have at least one filter configured Netreo begins scanning your CMDB every 5 minutes for new devices and adds them to Netreo as managed devices as they are found.