> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Configure Itential ServiceNow application

> How to configure an Itential Platform instance using the Itential ServiceNow Application within the ServiceNow platform.

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](/itential-cloud/cloud-hub/administration/service-accounts)

## Configure the Itential Instance

#### Navigate to Itential Platform Instances Config

Click the **All** tab at the top left-hand corner, click the **Itential** drop-down menu, and then select the **Itential Platform Instances Config** option.

#### 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.

#### 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.

![](/_fern-img/44c75c06f3da6562b69bf5308c8c8b950635a142de90c5caf20994391eedd403.webp)![](/_fern-img/e83516fdda84804b1327052766c6de58551c608a7444aadd3100f3f1849510ca.webp)![](/_fern-img/abf98c599e4df4882452674f1af7319e5bbc4414f5a631d9de6cee6b90dd2400.webp)

#### 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.

#### 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.

#### Add Roles

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

#### 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.

#### 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.

#### Submit the configuration

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

![](/_fern-img/ba2b72d7bfc52791837a506ae6babb8d8bc803a39e91fecd05bd7ac8f648bf41.webp)

## Permission Settings

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

| OnPrem Role | SaaS Role                       | Itential Platform      | Description                                                                                                                                                   |
| :---------- | :------------------------------ | :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `admin`     | `admin`                         | Adapter or Application | Ability to get dynamic data from an adapter or Itential Platform Application requires additional permissions. This includes `admin` for the specific adapter. |
| `apiread`   | `forms:read`                    | JSON Forms             | Ability to get a JSON Form associated with the trigger.                                                                                                       |
| `apiread`   | `cloud-automation:read`         | Operations Manager     | Ability to get a list of automations from Itential Platform.                                                                                                  |
| `apiread`   | `workflows:triggers:read`       | Operations Manager     | Ability to get triggers for an automation from Itential Platform.                                                                                             |
| `apiread`   | `jobs:read` `cloud-job:read`    | Operations Manager     | Ability to get information on a triggered Job from Itential Platform.                                                                                         |
| `apiwrite`  | `jobs:write` `cloud-automation` | Workflow Engine        | Ability to execute a trigger.                                                                                                                                 |

To read how Itential Cloud governs role permissions see → [Itential Cloud Group Administration](/itential-cloud/cloud-hub/administration/manage-users-groups)

![](/_fern-img/0f155d8828648e2812d50a5e72cbe7cede0ac4dfd05e0650adf3c425af45a47d.webp)![](/_fern-img/0f155d8828648e2812d50a5e72cbe7cede0ac4dfd05e0650adf3c425af45a47d.webp)![](/_fern-img/be26b69cd08d22bca8c0ec523e0d4dd62cb241d025ddd0a0f6894a3d6f9234b0.webp)