eLux-Unable to Authenticate with Smart Card Reader in Citrix

book

Article ID: CTX695585

calendar_today

Updated On:

Description

parameterAfter upgrading from an older version of Citrix Workspace App to version 21.12 or later, smart card authentication may fail entirely. This issue is caused by a change in the DriverName configuration parameters used in the module.ini configuration file.

before 21.12:
[SmartCard]
DriverName=VDSCARD.DLL

since 21.12:
[SmartCard]
DriverName=VDSCARDV2.DLL

Cause

The issue arises from a mismatch in the smart card driver configuration after upgrading to CWA 21.12 or newer. The older driver ( VDSCARD.DLL) is no longer compatible, and must be replaced with VDSCARDV2.DLL in the module.ini file.

Resolution

To restore smart card authentication:

  1. Access Advanced Device Configuration : Open the Advanced device configuration for the relevant OU or device.

  2. Manually update the configuration :

    • File:/setup/ica/module.ini

    • Section:SmartCard

    • Key:DriverName

    • Value:VDSCARDV2.DLL

  3. Apply and save changes : Save the updated configuration and restart the device.

  4. Test authentication : Attempt to log into Citrix using the smart card reader to confirm successful authentication.

Issue/Introduction

Users may be unable to log into Citrix using a smart card reader after upgrading to Citrix Workspace App (CWA) version 21.12 or newer. This is due to a change in the required driver configuration.

Powered by Wolken Software