Open in the explorer

Smart card authentication

Type
Computer
GPO path
Computer Configuration › Policies › Administrative Templates › Citrix Components › Citrix Workspace › User authentication
Supported on
All Citrix Workspace supported platforms
ADMX file
receiver.admx
Internal name
receiver/Policy_Smartcard

Explanation

Use this policy to control how the client uses smart cards attached to the client device.

When enabled, this policy allows the remote server to access smart cards attached to the client device for authentication and other purposes.

When disabled, the server cannot access smart cards attached to the client device.

Troubleshooting:
When using smart cards in a Citrix environment, the smart card device driver must be installed on the server. When using a different operating system on the client machine, it may be necessary to ensure that the smart card device drivers in use interoperate correctly.

Registry

HKEY_LOCAL_MACHINE\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Smartcard
Value name
SmartCardAllowed
StateValue written
EnabledREG_SZ = *
DisabledREG_SZ = false

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_Smartcard
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Smartcard'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'SmartCardAllowed' -Value '*' -Type String
# Allow smart card authentication
# unchecked: false
Set-ItemProperty -Path $k -Name 'SmartCardAllowed' -Value '*' -Type String
# Use pass-through authentication for PIN
# unchecked: *
Set-ItemProperty -Path $k -Name 'DisableCtrlAltDel' -Value 'true,false' -Type String

Disable

# Disable: receiver/Policy_Smartcard
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Smartcard'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'SmartCardAllowed' -Value 'false' -Type String

Revert to "Not configured"

# Revert to "Not configured": receiver/Policy_Smartcard
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Smartcard'
Remove-ItemProperty -Path $k -Name 'SmartCardAllowed' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'DisableCtrlAltDel' -ErrorAction SilentlyContinue

Options (2)

LabelControlRegistry valueREG typeConstraints / details
Allow smart card authenticationPart_Smartcard_EnableCheck boxbooleanSmartCardAllowedREG_SZ
Default (UI): true
Checked: REG_SZ = *
Unchecked: REG_SZ = false
Use pass-through authentication for PINPart_SmartcardPin_EnableCheck boxbooleanDisableCtrlAltDelREG_SZ
Checked: REG_SZ = true,false
Unchecked: REG_SZ = *

Application

Citrix Workspace app (Citrix) — October 2026 templates

October 2026 templates from pl4nty/web-admx-tool.