Application Dependencies

These are the application dependencies that enable the Itential Automation Services Application to run:

• Itential Automation Platform
• ServiceNow Permissions
• Network Requirements
• Credentials

Itential Automation Platform

The Itential Automation Services Application requires an instance of the Itential Automation Platform running version 2022.x, 2023.x, or later - or running IAP from the Itential Cloud Service.

ServiceNow Permissions

The required permissions and roles to use when setting up the Application within ServiceNow are:

• x_itent_admin - This role allows the user to have administrative rights on the Itential Automation Services Application. Admins have the ability to update the IAP Instance Config table. |
• x_itent_user - This role allows the user to have rights to use the Itential Automation Services Application. They will only be able to use the IAP Instances within the IAP Instance Config table that allow the x_itent_user role.

Network Requirements

To integrate to Itential, the ServiceNow server must be able to send API calls to the Itential server. If there are firewalls, at a minimum, the port and IP address you use for access to Itential (e.g. 3443) must be opened from ServiceNow to Itential.

Another solution that will allow the ServiceNow Server to connect to the Itential server is to utilize a MID Server. The MID Server should provide a route from the ServiceNow server to the Itential Server. You should follow the ServiceNow process for installing a MID Server. Once it is installed and configured in ServiceNow, you can add the MID Server reference and name to the IAP Instance Config table for your IAP instance.

Credentials

To integrate the ServiceNow server to Itential, you must know how to authenticate to your instance of Itential and configure the Itential Automation Services Application accordingly.

In the latest version of the application, sensitive information is now hidden by using the ServiceNow Password2 data type. This means the password, token and client_secret will now appear masked in the IAP instances config table instead of being clearly visible. Even if you already had your IAP instance configured, these fields will still be masked in the IAP instances config table now. Although there are differences in the GUI between pre-existing (earlier version) instances and newer instances, the code has been written to handle both scenarios.

In 2023.1, on-premise instances of Itential support OAuth 2.0 authentication. This allows you to create a service account to get a client ID and secret which the Itential Automation Services Application can use to authenticate to Itential.

All Itential cloud instances support API key authentication. Itential Cloud Operations can assist in getting you an API key to use to integrate with Itential. Please contact your Itential technical representative directly or open a support ticket.