For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Open sourceSupportFAQsDocs Home
DocumentationAPI ReferenceRelease notes
DocumentationAPI ReferenceRelease notes
  • Platform Cloud
    • Overview
    • Cloud vs. on-prem
    • Architecture
  • Apps
      • Overview
      • Navigate
      • Configuration
      • Gateway configuration
      • Status
      • Applications
      • Adapters
      • Repositories
    • FlowAI
  • Resources
    • Itential Academy
    • Itential MCP
    • Accessibility conformance
    • Get support
    • FAQs
LogoLogo
Open sourceSupportFAQsDocs Home
On this page
  • Before you begin
  • Set the Platform default cluster
  • Configure integration settings
  • Override the cluster for integration
  • Select a default execution mode
AppsAdmin Essentials

Gateway configuration

Was this page helpful?
Previous

Status

Next
Built with
Platform 6.4.0+

Use Gateway Configuration in Admin Essentials to configure how integrations execute through your customer-hosted Itential Automation Gateway 5 (IAG 5) deployment. Outbound API calls originate from your IAG 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 IAG 5 version 5.4 or later must be registered in Gateway Manager. For information, see Gateway Manager overview and Create a gateway cluster.

Set the Platform default cluster

Use the Platform Default section to designate the default gateway cluster that all IAG 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:

1

In Admin Essentials, go to Gateway Configuration.

2

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

3

Click Save.

Some considerations:

  • If the designated cluster is disconnected or becomes unavailable after you save, IAG 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.

Override the cluster for integration

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

1

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

2

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.

1

Select an execution mode

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

Execution modeDescription
Direct connectionRequests are executed from Platform without a cluster or proxy server. Use this for internal services that don’t require gateway routing.
Default cluster, no proxyRequests 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 proxyRequests are executed from the feature-level default cluster and an outbound proxy server. Selecting this mode reveals proxy configuration fields.
2

Configure proxy settings (Default cluster with proxy only)

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

Platform supports HTTPS proxies only.

FieldDescription
Hostname or IP addressThe hostname or IP address of the proxy server.
PortThe port used to connect to the proxy server.
Proxy authentication typeThe 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.
3

Save

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