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 and installed to your path.

Ensure you have your ServiceNow URL and a user that AMP will use to connect. This should have the role to allow exploring applications via REST API.

Configure a profile for amp-cmdb to connect to ServiceNow; we assume the profile name is aws-snow; the instance ID and username should match your environment:

% amp-cmdb profile --create

? Profile type snow
? Profile name aws-snow
? Instance ID or full URL, e.g. dev102288 or https://snow.intranet.io dev216029
? Username admin
? Password [hidden]

Discover ServiceNow applications

Adjust command in discovery blueprint sample if amp-cmdb is not in the path or if the ServiceNow profile is different to the default.

Then deploy the 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.

You may need to adjust permissions. 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

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

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

Deploy the incident creator blueprint sample as before.