To use ServiceNow as an Apica Target for Webhook delivery, configure OAuthaccess in ServiceNow from their Application Registry Menu.

When you are signed in to your ServiceNow instance as an administrator, you can configure OAuth 2 access in the Application Registry.

Open the Application Registry

To open the Application Registry:

• Go to your instance web address ( https://<instance>.service-now.com)

• You can create a set of client credentials in the ServiceNow Application Registry.

• Login in as a user with administrator access

• Find System OAuth in the navigator

• Click Application Registry

The ServiceNow Application Registry contains a list of applications that are registered for OAuth 2 authorization.

Add Credentials

To add a new set of credentials:

• Start in the Application Registry

• Click New

A new application is created.

• Enter a name for the application

• The Client ID is generated automatically and cannot be changed.

• Enter a Client Secret passphrase, or leave it blank to have it automatically generated for you

• Click Submit

The application is added to the OAuth Provider table.

1. Open the ServiceNow Application Registry

To open the Application Registry:

• Go to your instance web address ( https://<instance>.service-now.com):

• Login in as a user with administrator access

• Find System OAuth in the navigator

Find and Get the Credentials

The ServiceNow Application Registry contains a list of applications that are registered for OAuth authorization.

To find credential details:

• Start in the Application Registry

• In the OAuth section Webhook ServiceNow Integration Setup configuration in the table

• Click the application name to view the details

The OAuth Client ID

The Client ID is displayed in plain text in the Client ID box and can be copied directly.

Copy this for the first part of the ServiceNow Webhook integration Authentication

The Client Secret

The Client Secret is hidden by default, so you need to display it in plain text in order to copy it.

View the Client Secret by clicking the padlock next to the Client Secret box

• The client secret is then displayed in plain text and can be copied directly from there.

Copy this for the second part of the ServiceNow Webhook integration Authentication

Login

• Go to your instance web address ( https://<instance>.service-now.com)

• Login in as a user with administrator ac

Open the REST API Explorer

• Find System Web Services in the navigator

• Select REST

• Select REST API Explorer*

• Click Explore

The REST API Explorer is shown.

In the API Explorer, you can select the Incident table and view details about the parameters.

Find Incident Parameters

To find information about a parameter:

• Find the Path Parameters section

• Select Incidents in the tableName dropdown menu

• Find the Request Body section

• Select the Builder tab

• Choose the desired parameter in the Parameter dropdown menu

• The valid type for the parameters is shown in the Type box:

To find the User Name for a particular user:

• Go to your instance web address ( https://<instance>.service-now.com)

• Login in as a user with administrator access

Find Organization in the navigation

• Select Users

• Search the table for the user you want

• Copy from the User ID column in the table

Create a ServiceNow Target

To add a ServiceNow target, click the WebHook button

A blank target is created:

Navigate down to ServiceNow

Add the ServiceNow “Target” Fields

Target Name

• Enter a name that identifies the ServiceNow target in ASM.

Host

• Enter the ID of the ServiceNow instance which is typically the same as the subdomain in the ServiceNow URL (http://<host>.service-now.com).

Client ID

• Enter the OAuth authentication identifier of the ServiceNow by copying the Client ID from the Webhook ServiceNow Integration OAuth Credentials in your ServiceNow instance and paste it into the text box.

Client Secret

• Enter the OAuth client secret configured in ServiceNow buy copying the Client Secret from a Webhook ServiceNow Integration OAuth Credentials in your ServiceNow instance and paste it into the text box.

Username

• Enter the Username that logs into the ServiceNow instance. This can be any valid and active ServiceNow user.

• Copy the user name from your ServiceNow User Names/ID (From ServiceNow Portal) and paste it into the text box.

Password

• Enter the Password is the password used to login to the ServiceNow instance. This can be the password for any valid and active ServiceNow user, but it needs to match the ServiceNow Username setting.

• Copy the password from the correct user in your ServiceNow instance and paste it into the text box.

Caller

• Enter a ServiceNow user which is in incidents created from alerts, to populate the caller field. This can be any valid and active ServiceNow user and can be different from the ServiceNow Username setting.

• Copy the user name from your ServiceNow User Names/ID (From ServiceNow Portal) and paste it into the text box.

Short Description

• Enter descriptive text for the alert/incident in the text box for ServiceNow incidents which are created from alerts. This will populate the short description field. You can use Message Placeholders in the description to add dynamic information from the check.

Creating Incident

• Add any number of parameters to the incident when it is created in ServiceNow.

• Select a parameter in the Key dropdown menu

• Enter a value for the Value parameter

• Click the Add button

Resolving Incident

• Here, add any number of parameters to the created incident in ServiceNow when the incident has been resolved.

• Select a parameter in the Key dropdown menu

• Enter a value for the Value parameter

• Click the Add button

Add WebHook Target

• When you are happy with all the settings, create the target with the Add WebHook Target button.

• Target is created, containing the selected user/targets.