Some network environments are set up to have a proxy between the Itential Platform server and
the Internet. For those environments, Itential provides proxy support for both HTTP and HTTPS.
Supported features
The following features and subsystems use the proxy setting:
- Azure AAA Adapter
- Workflow Engine restCall task
- Itential Pre-Builts
- Itential Integrations
Before you begin
Determine whether your network environment requires:
- An HTTP or HTTPS proxy server
- Proxy authentication (username and password)
Important
While HTTP proxy configuration is supported, you should not configure HTTP proxies in production environments. HTTP proxies make connections insecure and can transmit sensitive data over unencrypted channels. Use HTTPS proxies for production deployments.
Configure proxy settings
To configure the Itential Platform to use a proxy server:
- Set the appropriate environment variable in the session where Itential Platform starts.
For HTTPS proxy (recommended):
bash export HTTPS_PROXY=https://internal-proxy.uat.domain.io:3128
For HTTP proxy:
bash export HTTP_PROXY=http://insecure-proxy.uat.domain.io:3128
- (Optional) If your proxy requires authentication, include credentials in the URL:
bash export HTTPS_PROXY=https://username:password@proxy.uat.itential.io:3128
If authentication is not required, skip this step.
- Restart the Itential Platform to apply the settings.