cloudsoft.io

Integration with ServiceNow

Prerequisites

Add amp-cmdb-integration bundle to the AMP catalog using AMP CLI

br catalog add amp-cmdb-integration-{version}.jar

This documentation uses a Cloudsoft script available by arrangement named amp-cmdb.

Create ServiceNow dev account and start dev instance. Create admin user in ServiceNow Users table with the role allowing exploring applications via REST API.

Add amp-cmdb to PATH, either with npm link or with a soft link

ln -s amp-cmdb.js /usr/bin/amp-cmdb

Configure ServiceNow profile with name amp-snow

amp-cmdb profile --create

select snow, set dev instance and admin user, registered in step above.

Discover ServiceNow applications

Adjust command in discovery blueprint sample if path to amp-cmdb or ServiceNow profile not set with names advised in pre-requisites. Deploy discovery blueprint sample

br deploy snow-discovery-policy.yaml

Navigate to App Inspector and expand ‘ServiceNow Discovery’ application to see applications discovered as children nodes. See sensors of each discovered application.

Publish AMP application to ServiceNow

Adjust command in exporter blueprint sample if path to amp-cmdb or ServiceNow profile not set with names advised in pre-requisites.

Notice you can override the default incident urgency and impact by passing the numerical value as parameters to the command:

amp-cmdb snow --profile amp-snow  --publish_incident --urgency 1 --impact 1

Find security_admin in Roles and check the elevated privilege setting (elevate security_admin in System Administrator menu first in order to be able to find it in Roles). Find label_entry.table and label_entry.table_key in Access Controls (ACL) and add admin role to the write operation if not added. This is required for ServiceNow to be able to add tags to applications via REST API.

Deploy exporter blueprint sample

br deploy snow-exporter-policy.yaml

Navigate to ServiceNow applications and find ‘ServiceNow Exporter’ application.

Create and update incidents in ServiceNow

Procer as for the exporter policy adjuncting the command and setting up the admin user for writing in the label fields.

Deploy incident creator blueprint sample