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

# Gateway configuration

> Configure the Platform default gateway cluster and integration-level execution and proxy settings in Admin Essentials.

Use **Gateway Configuration** in Admin Essentials to configure how integrations execute through your customer-hosted Itential Gateway 5 (Gateway 5) deployment. Outbound API calls originate from your Gateway 5 environment rather than from Itential's cloud, so they pass through your existing network controls.

If your network requires outbound traffic to pass through a

proxy server

, you can configure it here once and all integrations inherit it by default.

## Before you begin

At least one gateway cluster running Gateway 5 version 5.4 or later must be registered in Gateway Manager. For information, see [Gateway Manager overview](/itential-gateway/gateway-manager-overview) and [Create a gateway cluster](/itential-gateway/create-gateway-cluster).

## Set the Platform default cluster

Use the **Platform Default** section to designate the default gateway cluster that all Gateway 5-dependent features inherit when no feature-specific cluster is set.

Setting the Platform default cluster does not guarantee availability. If the cluster configured for a specific feature becomes unavailable, Platform returns an error — it does not fall back to the default.

To set the Platform default cluster:

In Admin Essentials, go to **Gateway Configuration**.

In the **Platform Default** section, select a **Default Cluster** from clusters registered in Gateway Manager.

Click **Save**.

Some considerations:

* If the designated cluster is disconnected or becomes unavailable after you save, Gateway 5-dependent features become inaccessible and you must reconfigure this setting.

## Configure integration settings

**Feature-Specific Execution Defaults** lets you choose a different gateway cluster for a specific feature, such as integrations, and configure additional settings for it. These settings apply to all integrations by default. Individual integrations can override the cluster and proxy settings configured here. For more information, see [Manage integrations](/itential-platform/admin-essentials/integrations/manage).

### Override the cluster for integration

By default, integrations use the Platform default cluster. To route integrations through a different cluster:

Under **Integrations**, select a cluster from the **Default cluster** dropdown.

Click **Save**. Integrations use this cluster instead of the Platform default.

### Select a default execution mode

The **Default Execution Mode** setting controls how integration requests are routed. Each integration can override this setting from its own configuration page.

#### Select an execution mode

Under **Integrations**, select one of the following from the **Default Execution Mode** dropdown:

| Execution mode                 | Description                                                                                                                                                            |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Direct connection**          | Requests are executed from Platform without a cluster or proxy server. Use this for internal services that don't require gateway routing.                              |
| **Default cluster, no proxy**  | Requests are executed from the feature-level default cluster without a proxy server. Use this when gateway execution is required but your network doesn't use a proxy. |
| **Default cluster with proxy** | Requests are executed from the feature-level default cluster and an outbound proxy server. Selecting this mode reveals proxy configuration fields.                     |

#### Configure proxy settings (Default cluster with proxy only)

If you selected **Default cluster with proxy**, configure the following fields:

Platform supports HTTPS proxies only.

| Field                         | Description                                                                                                                       |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Hostname or IP address**    | The hostname or IP address of the proxy server.                                                                                   |
| **Port**                      | The port used to connect to the proxy server.                                                                                     |
| **Proxy authentication type** | The authentication method for the proxy server. Options: **No authentication**, **Basic authentication**, or **Secrets manager**. |

For **Proxy authentication type**, configure one of the following:

* **Basic authentication**: Enter a username and password.
* **Secrets manager**: Enter the keys used to look up the proxy credentials. Platform retrieves the credentials at runtime. For supported systems and setup, see [Secrets management overview](/itential-platform/secrets/overview).

#### Save

Click **Save**. Changes take effect immediately, without a Platform restart.

> Configure the Platform default gateway cluster and integration-level execution and proxy settings in Admin Essentials.