Configuration

This section of the guide provides information on how to configure an IAP instance using the Itential Automation Services app within the ServiceNow platform.

Configure the Itential Instance

1. Click the All tab at the top left-hand corner, click the Itential drop-down menu, and then select the IAP Instances Config option.
2. Click the Instance you want to configure, or click the New icon (top right-hand corner) to configure a new instance.
3. Type the Name, IP Address (or Hostname) with the port number in the the respective fields.
   1. You may have to unlock the hostname. The IP/Hostname should be the URL of the Itential server (e.g. https://myiap.com:3443). HTTPS will be required.

Figure 1: IAP Instances Config

 

Figure 2: Instances Table

 

Figure 3: New Instance Config Form

 

4. 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.
5. 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.
   1. Username/Password
   2. API Key requires a static token.
   3. OAuth 2.0 requires a client_id and client_secret to retrieve a token.
6. Add the Roles that have access to this IAP Instance.
7. If using a MID Server to communicate with IAP, provide the reference to the MID Server and the MID Server name.
   1. To find the reference, use the search icon (magnifying glass) at the end of the **MID_server **field.
   2. The reference is utilized by Itential Actions and the name is critical for the Client GUI React Application.
8. Input the request_timeout to set the timeout for the API calls to IAP. If it is not provided, the default timeout within ServiceNow will be used.
9. Click Submit (upper-right corner) to set the new instance configurations.

Figure 4: Submit New Instance Configurations

IAP Permission Settings

The ServiceNow Application requires the user to have certain permissions within Itential Automation Platform (Itential Cloud).

Figure 5: Roles - JSON Forms

 

Figure 6: Roles - Operations Manager

 

Figure 7: Roles - Workflow Engine