Policy
Configure Client failover proxy settings
Citrix Workspace
Policy overview
Key metadata and intent for this policy.
Use this policy to configure alternative network proxies that the client can use if the primary network proxy fails to connect to a remote application or desktop. When this policy is not configured, the client will use its own settings to decide whether to connect through a proxy server. When this policy is enabled, the client will attempt a connection using an alternative proxy if connection to a primary proxy fails. The failover proxy settings operate in an identical fashion to the primary proxy settings. If both the primary and alternative proxy fail to service the connection, selecting the "Failover to direct" check box instructs the client to attempt a final direct connection with no proxies. Troubleshooting: Some proxy failures can make the client appear to hang on connection. This is usually due to the proxy server reattempting the connection itself, or having a long time-out period. Depending on the network topology, it may be preferable to configure the Web Interface server to identify the currently functioning proxy, or alter the proxy server time-out settings.
Registry values
How enabled and disabled states update the registry.
No explicit registry values are set for enabled or disabled states.
Policy elements
Inputs and configuration options exposed by this policy.
| Scope | Element | Type | Registry mapping | Constraints & behavior | Copy |
|---|---|---|---|---|---|
Proxy types ID Part_AltProxy_ProxyTypeLockdown | enum | Path Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy Value name AltProxyType Type REG_SZ | Options: Auto (Auto), None (None), SOCKS (SOCKS), SOCKSv4 (SOCKSv4), SOCKSv5 (SOCKSv5), Secure (Secure), Script (Script) | ||
| Computer | Failover to direct ID Part_AltProxy_ProxyFallbackLockdown | boolean | Path Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy Value name ProxyFallback Type REG_SZ | Options: true (true,false), false () True: Set value = "true,false" · False: Set value = "" | |
Proxy script URLs ID Part_AltProxy_ProxyAutoConfigUrlLockdown | text | Path Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy Value name AltProxyAutoConfigUrl Type REG_SZ | None | ||
Bypass server list ID Part_AltProxy_ProxyBypassListLockdown | text | Path Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy Value name AltProxyBypassList Type REG_SZ | None | ||
| User | Failover to direct ID Part_AltProxy_ProxyFallbackLockdown | text | Path Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy Value name ProxyFallback Type REG_SZ | None | |
Proxy host names ID Part_AltProxy_ProxyHostLockdown | text | Path Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy Value name AltProxyHost Type REG_SZ | None | ||
Proxy ports ID Part_AltProxy_ProxyPortLockdown | text | Path Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy Value name AltProxyPort Type REG_SZ | None |