OAuth Redirection
Explanation
OAuth Redirection allows configuring URL patterns to allow OAuth logins to be redirected over Bidirectional Content Redirection.
-OAuth Pattern : This indicates the list of URL regular expressions that, when redirected to the client via Host-to-Client URL redirection, will be tracked as if an OAuth authentication flow has begun, and when the flow completes that resulting URL will be redirected back into the Host VDA that initiated that flow.. Semi Colon ";" acts as a delimeter.
-OAuth Scheme : This indicates the scheme of URLs .If a Scheme is specified, the terminating URL is expected to be of the form: scheme://something. If Scheme is not specified (empty), then the original resulting URL pattern is extracted from the Pattern via a regular expression capture group (must be specified in the Pattern). Semi Colon ";" acts as a delimeter.
Note:
1)Number of Patterns and scheme entries should match .If no scheme is specified for pattern just porvide ';' for empty scheme
2)OAuth Redirection works only if BidirectionalContentRedirection is enabled
Registry
HKEY_CURRENT_USER\Software\Policies\Citrix\ICA Client\OAuth Redirection- Value name
AllowOAuthRedirection
| State | Value written | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Enabled | REG_DWORD = 1
| ||||||||||||
| Disabled | REG_DWORD = 0 |
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_OAuthRedirection
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\OAuth Redirection'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'AllowOAuthRedirection' -Value 1 -Type DWord
# Pattern
Set-ItemProperty -Path $k -Name 'Pattern' -Value '<value>' -Type String
# Scheme
Set-ItemProperty -Path $k -Name 'Scheme' -Value '<value>' -Type String
$k = 'HKCU:\Software\Classes\citrix-oauth-redir'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name '' -Value 'URL:Citrix OAuth2 Redirection Helper' -Type String
Set-ItemProperty -Path $k -Name 'URL Protocol' -Value '' -Type String
$k = 'HKCU:\Software\Classes\citrix-oauth-redir\shell\open\command'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name '' -Value '"c:\Program Files (x86)\Citrix\ICA Client\redirector.exe" /launch "%1"' -Type StringDisable
# Disable: receiver/Policy_OAuthRedirection
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\OAuth Redirection'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'AllowOAuthRedirection' -Value 0 -Type DWordRevert to "Not configured"
# Revert to "Not configured": receiver/Policy_OAuthRedirection
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\OAuth Redirection'
Remove-ItemProperty -Path $k -Name 'AllowOAuthRedirection' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'Pattern' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'Scheme' -ErrorAction SilentlyContinue
$k = 'HKCU:\Software\Classes\citrix-oauth-redir'
Remove-ItemProperty -Path $k -Name 'URL Protocol' -ErrorAction SilentlyContinueOptions (2)
| Label | Control | Registry value | REG type | Constraints / details |
|---|---|---|---|---|
| Pattern:Part_OAuthRedirectionRedirectionPattern | Text boxtext | Pattern | REG_SZ | |
| Scheme:Part_OAuthRedirectionScheme | Text boxtext | Scheme | REG_SZ |
Application
Citrix Workspace app (Citrix) — October 2026 templates
October 2026 templates from pl4nty/web-admx-tool.