Configure Itential ServiceNow application

This section of the guide provides information on how to configure an Itential Platform instance using the Itential ServiceNow Application within the ServiceNow platform.

Related Reading: How to set up OAuth → Using Service Accounts to Access Itential Cloud APIs

Configure the Itential Instance

2

Select or create an instance

Click the Instance you want to configure, or click the New icon (top right-hand corner) to configure a new instance.

3

Enter Name and IP Address or Hostname

Type the Name, IP Address (or Hostname) with the port number in the respective fields.

You may have to unlock the hostname. The IP/Hostname should be the URL of the Itential server (e.g. https://myIP.com:3443). HTTPS will be required.

Itential Platform Instances Config
Instances Table
New Instance Config Form
1

Select the auth_type

Select the auth_type. This field was added in the latest version since the Password field is masked whether it has a value or not. Of note, the application and actions should work whether this field is provided or not.

2

Provide credentials

Provide your credentials based on the type of authentication you are using. Credentials will appear masked as you type them and when they are displayed in the table.

  • Username/Password
  • API Key requires a static token.
  • OAuth 2.0 requires a client_id and client_secret to retrieve a token.
3

Add Roles

Add the Roles that have access to this Itential Platform Instance.

4

Configure MID Server (if applicable)

If using a MID Server to communicate with Itential Platform, provide the reference to the MID Server and the MID Server name.

  • To find the reference, use the search icon (magnifying glass) at the end of the MID_server field.
  • The reference is utilized by Itential Actions and the name is critical for the Client GUI React Application.
5

Set request timeout

Input the request_timeout to set the timeout for the API calls to Itential Platform. If it is not provided, the default timeout within ServiceNow will be used.

6

Submit the configuration

Click Submit (upper-right corner) to set the new instance configurations.

Submit New Instance Configurations

Permission Settings

The ServiceNow Application requires the user to have certain permissions within Itential Platform.

OnPrem RoleSaaS RoleItential PlatformDescription
adminadminAdapter or ApplicationAbility to get dynamic data from an adapter or Itential Platform Application requires additional permissions. This includes admin for the specific adapter.
apireadforms:readJSON FormsAbility to get a JSON Form associated with the trigger.
apireadcloud-automation:readOperations ManagerAbility to get a list of automations from Itential Platform.
apireadworkflows:triggers:readOperations ManagerAbility to get triggers for an automation from Itential Platform.
apireadjobs:read
cloud-job:read
Operations ManagerAbility to get information on a triggered Job from Itential Platform.
apiwritejobs:write
cloud-automation
Workflow EngineAbility to execute a trigger.

To read how Itential Cloud governs role permissions see → Itential Cloud Group Administration

Roles - JSON Forms
Roles - Operations Manager
Roles - Workflow Engine