For the newer version of the ServiceNow Integration guide, click here.
You can add the ServiceNow integration from the Discover page.
Enter your ServiceNow instance name and the username/password you wish to use to access it.Note:
The minimum access required is read access to the change_request and incident tables. It is recommended to set the account up as a Web Service Access Only account.
Change Request Sync
By default the ServiceNow integration will sync change requests from your incident for display on the UpGuard timeline.
You can customize the types of changes that are sync’d by editing the Change Request Filter:
You can see that the default setting is to include all approved changes. The syntax used here is ServiceNow filter query syntax.
You can build your query in ServiceNow and right click it to get the correct syntax:
The ServiceNow integration also syncs incidents to the timeline:
As with the change request sync you can also customize the incidents that are sync’d by editing the filter query:
Unauthorized Change Detection
An advanced feature of the ServiceNow Integration is the ability to detect, and trigger incidents for, unauthorized change.
When activated for a specific environment, any time a change is detected on a node in that an environment, without an accompanying change request in ServiceNow for the change, an incident will be raised.
The user you use for the integration will need read access to the cmdb_ci table, and write permissions to the incident table for this feature to work.
To activate this feature simply choose Yes for the setting and select the environment(s) you would like it activated on. Note that you can filter the change requests used for validation as well.