For the older version of ServiceNow Integration guide, click here.
To integrate UpGuard with ServiceNow, the UpGuard Change Authorization App needs to be installed on ServiceNow instance.
ServiceNow Environment Setup
For UpGuard Change Authorization to work, the ServiceNow instance should have the change management plugin installed. If you have the necessary plugin installed, skip to Installation Guide.
In your ServiceNow environment, navigate to System Definition > Plugins.
Navigate to Change within System Plugins.
Install Change Management - Core and Change Management - State Model.
- Navigate to UpGuard Settings.
Change the application.
a. Click on the settings wheel.
b. Select UpGuard Change Authorization under Application.
- Update Get UpGuard URL, Service API Key and Secret Key.
Refer to this page for details on getting the credentials.
Enter in details for API in UpGuard Settings. Click Save.
Navigate to UpGuard Setup.
- Select Test Connections.
A pop-up will appear when the credentials have been successfully validated. If the authentication process failed in Step 4, make sure you enter the right credentials and repeat Step 3 - 6 again.
Click on Run Scripts.
Upon success, this pop-up will appear.
The application is now able to receive data from UpGuard.
Configuring the application
To ensure that the integration application will run according to your business requirements, please configure the following ‘General Application Settings’ with the following customizable fields:
UpGuard Diff Retention
Diff Retention allows you to configure how long would you like to store the Diff Data on ServiceNow Tables.
Every 30 minutes, the application will scan and retrieve changes from UpGuard/ServiceNow and automatically create a Change Incident for the last 24 hours. This will be stored under UpGuard Change Authorization -> Node Diff :
The storage of this data is for audit purpose. Admin can utilize this data to see what change can be made.
UpGuard Environment Filter
As a System Administrator, you are able to select the environments for the application to scan. To know which IDs are associated to each environment, you will need to navigate to UpGuard Change Authorization -> UpGuard Environments:
This table shows you the list of environments detected by UpGuard with its corresponding ID tags. Select the environment ID tags that you will like to include and enter them under UpGuard Settings -> Environment Filter.
Upon selecting “Yes”, logs will be visible in Application Logs. This will provide detailed information on the integration application.
Under Application Logs, you are able to see in detail the output of the scripts that ran every 30 minutes.
ServiceNow Incident Creation
UpGuard Change Authorization detects if there are unrealized, unauthorized and unregistered Change Incidents and will store this information in a daily generated report.
If you would like to better keep track of these use cases, you can check Incident Creation. From there on you can set the incident priority, urgency and impact for incidents created by UpGuard.
Installation and configuration is complete. UpGuard will continuously monitor your Change Requests and environment changes every 30 minutes, and update the incident reports automatically should there be any unauthorized changes between the 2 applications.