Proxies
Avantra uses outgoing HTTP proxies for external connections, including notifications, cloud service monitoring, and license activation. Proxies are configured centrally and can be assigned to services that require outbound internet access.
Managing proxies
To open the proxy manager, navigate to Configuration > Integrations > Proxies. From here you can create, edit, and delete proxy definitions.
Each proxy has the following fields:
| Field | Description |
|---|---|
| Name | A unique identifier for the proxy. |
| HTTP Proxy Host | The hostname or IP address of the proxy server, optionally including the port (for example, proxy.corp.com:8080). |
| HTTP Proxy User | Optional. The username for proxy authentication. |
| HTTP Proxy Password | Optional. The password for proxy authentication. |
| Bypass hosts | Optional. A semicolon-separated list of hostnames or IP addresses that should bypass the proxy (for example, localhost;127.0.0.1). |
System-managed proxies
You can define two default proxy roles, the Default Proxy and the Avantra API Proxy, which determine how outbound connections are routed. You define these by clicking 
Set default.
| Proxy role | Purpose |
|---|---|
| Default Proxy | The default outgoing proxy for notifications, cloud service connections, AIR reports, OAuth2 token retrieval, VMware sync, ServiceNow, SAP HotNews/OSDB, and WSDL loading. |
| Avantra API Proxy | The proxy used for license activation, add-in API access, and update checks. If not configured, the Default Proxy is used instead. |
Each proxy can be assigned to either, both, or neither of these roles. If a default proxy is assigned, but the Avantra API Proxy role is not assigned to any proxy, then the Default Proxy will be used for all outbound connections. If neither role is assigned to any proxy, then no outgoing connections will use a proxy.
Upgrading from a previous version
Deprecation of legacy proxy parameters.
Prior to Avantra 26.0, outgoing proxy settings were configured as individual parameters under Administration > Settings > Avantra UI:
HttpProxyHost,HttpProxyUser,HttpProxyPassword,HttpProxyBypass— general outgoing proxyLicenseActivationHttpProxyHost,LicenseActivationHttpProxyUser,LicenseActivationHttpProxyPassword— license activation proxy
On upgrade to 26.0, if any of those parameters had values configured, Avantra automatically migrates them to proxy credentials named Default Proxy and Avantra API Proxy respectively, and assigns them to the corresponding proxy roles. If the parameters were not configured, no proxy credentials are created automatically.
The legacy parameters are no longer active.