Configure Client failover proxy settings
Explanation
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
HKEY_LOCAL_MACHINE\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy- Value name
- not defined in the ADMX
Enable / disable values: not defined in the ADMX (see the options below).
PowerShell
PowerShell commands that write to the registry what the policy would write. Values in angle brackets (<…>) must be replaced.
Writing directly to the registry bypasses Group Policy: if a GPO manages this value, it will be rewritten at the next gpupdate; otherwise the value stays in place (the "tattooing" effect). Prefer a GPO or, locally, LGPO.exe. Run PowerShell as administrator for HKLM. Some policies need a restart or gpupdate /force.
Enable
# Enable: receiver/Policy_AltProxyLockdown
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Proxy types
# Possible options:
# Auto = Auto
# None = None
# SOCKS = SOCKS
# SOCKSv4 = SOCKSv4
# SOCKSv5 = SOCKSv5
# Secure = Secure
# Script = Script
Set-ItemProperty -Path $k -Name 'AltProxyType' -Value 'Auto' -Type String
# Proxy host names
Set-ItemProperty -Path $k -Name 'AltProxyHost' -Value '<value>' -Type String
# Proxy ports
Set-ItemProperty -Path $k -Name 'AltProxyPort' -Value '<value>' -Type String
# Proxy script URLs
Set-ItemProperty -Path $k -Name 'AltProxyAutoConfigUrl' -Value '<value>' -Type String
# Bypass server list
Set-ItemProperty -Path $k -Name 'AltProxyBypassList' -Value '<value>' -Type String
# Failover to direct
# unchecked: false
Set-ItemProperty -Path $k -Name 'ProxyFallback' -Value 'true,false' -Type StringDisable
# Disable: receiver/Policy_AltProxyLockdown
# No value is written in the "Disabled" state (nothing defined in the ADMX)Revert to "Not configured"
# Revert to "Not configured": receiver/Policy_AltProxyLockdown
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy'
Remove-ItemProperty -Path $k -Name 'AltProxyType' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'AltProxyHost' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'AltProxyPort' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'AltProxyAutoConfigUrl' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'AltProxyBypassList' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ProxyFallback' -ErrorAction SilentlyContinueOptions (6)
| Label | Control | Registry value | REG type | Constraints / details | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Proxy typesPart_AltProxy_ProxyTypeLockdown | Drop-down listenum | AltProxyType | REG_SZ |
| ||||||||||||||||
| Proxy host namesPart_AltProxy_ProxyHostLockdown | Text boxtext | AltProxyHost | REG_SZ | |||||||||||||||||
| Proxy portsPart_AltProxy_ProxyPortLockdown | Text boxtext | AltProxyPort | REG_SZ | |||||||||||||||||
| Proxy script URLsPart_AltProxy_ProxyAutoConfigUrlLockdown | Text boxtext | AltProxyAutoConfigUrl | REG_SZ | |||||||||||||||||
| Bypass server listPart_AltProxy_ProxyBypassListLockdown | Text boxtext | AltProxyBypassList | REG_SZ | |||||||||||||||||
| Failover to directPart_AltProxy_ProxyFallbackLockdown | Check boxboolean | ProxyFallback | REG_SZ | Default (UI): true Checked: REG_SZ = true,falseUnchecked: REG_SZ = false |
Application
Citrix Workspace app (Citrix) — October 2026 templates
October 2026 templates from pl4nty/web-admx-tool.