Tarjetas inteligentes

Last published : Nov 13, 2026
Puede usar una tarjeta inteligente conectada al dispositivo cliente para la autenticación al iniciar sesión en una sesión de escritorio virtual de Linux. Esta función se implementa mediante la redirección de tarjetas inteligentes a través del canal virtual de tarjetas inteligentes de ICA®. También puede usar la tarjeta inteligente dentro de la sesión. Los casos de uso incluyen agregar una firma digital a un documento, cifrar o descifrar un correo electrónico y autenticarse en un sitio web.
El VDA de Linux utiliza la misma configuración que el VDA de Windows para esta función. Para obtener más información, consulte la sección Configurar el entorno de tarjetas inteligentes de este artículo.
Nota:
No se admite el uso de una tarjeta inteligente asignada dentro de una sesión de VDA de Linux para iniciar sesión en Citrix Gateway.

Requisitos previos

La disponibilidad de la autenticación de paso a través de tarjetas inteligentes depende de las siguientes condiciones:
  • Su VDA de Linux está instalado en una de las siguientes distribuciones:
    • RHEL 8
    • RHEL 7/CentOS 7
    • Rocky Linux 8
    • Ubuntu 22.04
    • Ubuntu 20.04
    • Ubuntu 18.04
    • Debian 11.3
    • Debian 10.9
    Después de completar la instalación del VDA, verificar que su VDA puede registrarse en Delivery Controller™ y que puede abrir las sesiones de escritorio de Linux publicadas con credenciales de Windows.
  • Se utilizan tarjetas inteligentes compatibles con OpenSC. Para obtener más información, consulte Asegúrese de que OpenSC sea compatible con su tarjeta inteligente.
  • Se utiliza la aplicación Citrix Workspace™ para Windows.

Asegúrese de que OpenSC sea compatible con su tarjeta inteligente

OpenSC es un controlador de tarjetas inteligentes muy utilizado en RHEL 7.4+. Como reemplazo totalmente compatible de CoolKey, OpenSC admite muchos tipos de tarjetas inteligentes (consulte Soporte de tarjetas inteligentes en Red Hat Enterprise Linux).
En este artículo, la tarjeta inteligente YubiKey 4 se utiliza como ejemplo para ilustrar la configuración. YubiKey 4 es un dispositivo USB CCID PIV todo en uno que se puede adquirir fácilmente en Amazon u otros proveedores minoristas. El controlador OpenSC es compatible con YubiKey 4.
Yubikey4
Si su organización requiere otra tarjeta inteligente más avanzada, prepare una máquina física con una distribución de Linux compatible y el paquete OpenSC instalado. Para obtener información sobre la instalación de OpenSC, consulte (/es-es/linux-virtual-delivery-agent/2209/configure/authentication/support-for-smart-cards.html#install-the-smart-card-driver). Inserte su tarjeta inteligente y ejecute el siguiente comando para verificar que OpenSC es compatible con su tarjeta inteligente:
pkcs11-tool --module opensc-pkcs11.so --list-slots

Configuración

Preparar un certificado raíz

Se utiliza un certificado raíz para verificar el certificado de la tarjeta inteligente. Siga estos pasos para descargar e instalar un certificado raíz.
  1. Obtenga un certificado raíz en formato PEM, normalmente de su servidor de CA.
    Puede ejecutar un comando similar al siguiente para convertir un archivo DER (*.crt, *.cer, *.der) a PEM. En el siguiente ejemplo de comando, certnew.cer es un archivo DER.
    openssl x509 -inform der -in certnew.cer -out certnew.pem
  2. Instale el certificado raíz en el directorio openssl. El archivo certnew.pem se utiliza como ejemplo.
    cp certnew.pem <path where you install the root certificate>
    Para crear una ruta para instalar el certificado raíz, ejecute sudo mdkir -p <path where you install the root certificate>.

Crear el módulo pam_krb5 en RHEL 8 y Rocky Linux 8

La autenticación con tarjeta inteligente depende del módulo pam\_krb5, que está obsoleto en RHEL 8 y Rocky Linux 8. Para usar la autenticación con tarjeta inteligente en RHEL 8 y Rocky Linux 8, cree el módulo pam\_krb5 de la siguiente manera:
  1. Descargue el código fuente de pam_krb5-2.4.8-6 desde <https://centos.pkgs.org/7/centos-x86_64/pam_krb5-2.4.8-6.el7.x86_64.rpm.html>.
  2. Compile e instale el módulo pam\_krb5 en RHEL 8 y Rocky Linux 8.
    yum install -y opensc pcsc-lite pcsc-lite-libs pcsc-lite-ccid nss-tools
    yum install gcc krb5-devel pam-devel autoconf libtool
    rpm2cpio pam_krb5-2.4.8-6.el7.src.rpm | cpio –div
    tar xvzf pam_krb5-2.4.8.tar.gz
    cd pam_krb5-2.4.8
    ./configure --prefix=/usr
    make
    make install
  3. verificar que pam_krb5.so existe en /usr/lib64/security/.
    ls -l /usr/lib64/security | grep pam_krb5

Configurar el entorno de tarjeta inteligente

Puede usar el script ctxsmartlogon.sh para configurar el entorno de tarjeta inteligente o completar la configuración manualmente.

(Opción 1) Usar el script ctxsmartlogon.sh para configurar el entorno de tarjeta inteligente

Nota:
El script ctxsmartlogon.sh agrega información de PKINIT al dominio predeterminado. Puede cambiar esta configuración a través del archivo de configuración /etc/krb5.conf.
Antes de usar tarjetas inteligentes por primera vez, ejecute el script ctxsmartlogon.sh para configurar el entorno de tarjeta inteligente.
Sugerencia:
Si ha utilizado SSSD para unirse al dominio, reinicie el servicio SSSD después de ejecutar ctxsmartlogon.sh.
sudo /opt/Citrix/VDA/sbin/ctxsmartlogon.sh
Los resultados son similares a los siguientes:
Ejecutar el script ctxsmartlogon.sh y seleccionar sí
También puede inhabilitar las tarjetas inteligentes ejecutando el script ctxsmartlogon.sh:
sudo /opt/Citrix/VDA/sbin/ctxsmartlogon.sh
Los resultados son similares a los siguientes:
Ejecutar el script ctxsmartlogon.sh y seleccionar no

(Opción 2) configurar el entorno de tarjeta inteligente manualmente

El VDA de Linux utiliza el mismo entorno de tarjeta inteligente que el VDA de Windows. En este entorno, se deben configurar varios componentes, incluidos el controlador de dominio, la entidad de certificación (CA) de Microsoft, los servicios de Internet Information Services, Citrix StoreFront y la aplicación Citrix Workspace. Para obtener información sobre la configuración basada en la tarjeta inteligente YubiKey 4, consulte el artículo del centro de conocimiento CTX206156.
Antes de pasar al siguiente paso, asegúrese de que ha configurado todos los componentes correctamente, ha descargado la clave privada y el certificado de usuario en la tarjeta inteligente, y puede iniciar sesión correctamente en el VDA de Windows con la tarjeta inteligente.
Instalar los paquetes PC/SC Lite
PCSC Lite es una implementación de la especificación Personal Computer/Smart Card (PC/SC) en Linux. Proporciona una interfaz de tarjeta inteligente de Windows para comunicarse con tarjetas inteligentes y lectores. La redirección de tarjetas inteligentes en el VDA de Linux se implementa a nivel de PC/SC.
Ejecute el siguiente comando para instalar los paquetes PC/SC Lite:
RHEL 8, Rocky Linux 8, RHEL 7/CentOS 7:
yum install pcsc-lite pcsc-lite-ccid pcsc-lite-libs
Ubuntu 22.04, Ubuntu 20.04, Ubuntu 18.04, Debian 11.3, Debian 10.9:
apt-get install -y libpcsclite1 libccid
Instalar el controlador de tarjeta inteligente
OpenSC es un controlador de tarjeta inteligente muy utilizado. Si OpenSC no está instalado, ejecute el siguiente comando para instalarlo:
RHEL 8, Rocky Linux 8, RHEL 7/CentOS 7:
yum install opensc
Ubuntu 22.04, Ubuntu 20.04, Ubuntu 18.04, Debian 11.3, Debian 10.9:
apt-get install -y opensc
Instalar los módulos PAM para la autenticación con tarjeta inteligente
Ejecute el siguiente comando para instalar los módulos pam\_krb5 y krb5-pkinit.
RHEL 7/CentOS 7:
yum install pam_krb5 krb5-pkinit
RHEL 8, Rocky Linux 8:
yum install krb5-pkinit
Ubuntu 22.04, Ubuntu 20.04, Ubuntu 18.04:
apt-get install libpam-krb5 krb5-pkinit
Debian 11.3, Debian 10.9:
apt-get install -y libpam-krb5 krb5-pkinit
El módulo pam\_krb5 es un módulo de autenticación conectable que las aplicaciones compatibles con PAM pueden usar para comprobar contraseñas y obtener tickets de concesión de tickets del Centro de distribución de claves (KDC). El módulo krb5-pkinit contiene el complemento PKINIT que permite a los clientes obtener credenciales iniciales del KDC mediante una clave privada y un certificado.
Configurar el módulo pam\_krb5
El módulo pam\_krb5 interactúa con el KDC para obtener tickets Kerberos mediante certificados en la tarjeta inteligente. Para habilitar la autenticación pam_krb5 en PAM, ejecute el siguiente comando:
authconfig --enablekrb5 --update
En el archivo de configuración /etc/krb5.conf, añada la información de PKINIT según el dominio real.
Nota:
La opción pkinit_cert_match especifica reglas de coincidencia que el certificado del cliente debe cumplir antes de que se utilice para intentar la autenticación PKINIT. La sintaxis de las reglas de coincidencia es:
component-rule …
donde relation-operator puede ser &&, lo que significa que todas las reglas de componentes deben coincidir, o \|\|, lo que significa que solo una regla de componente debe coincidir.
A continuación, se muestra un ejemplo de un archivo krb5.conf genérico:
EXAMPLE.COM = {

    kdc = KDC.EXAMPLE.COM

    auth_to_local = RULE:[1:$1@$0]

    pkinit_anchors = FILE:<path where you install the root certificate>/certnew.pem

    pkinit_kdc_hostname = KDC.EXAMPLE.COM

    pkinit_cert_match = ||<EKU>msScLogin,<KU>digitalSignature

    pkinit_eku_checking = kpServerAuth

 }
El archivo de configuración es similar al siguiente después de añadir la información de PKINIT.
Información PKINIT añadida
Configurar la autenticación PAM
Los archivos de configuración de PAM indican qué módulos se utilizan para la autenticación PAM. Para añadir pam_krb5 como módulo de autenticación, añada la siguiente línea al archivo /etc/pam.d/smartcard-auth:
auth [success=done ignore=ignore default=die] pam_krb5.so preauth_options=X509_user_identity=PKCS11:<path to the pkcs11 driver>/opensc-pkcs11.so
El archivo de configuración es similar al siguiente después de la modificación si se utiliza SSSD.
Archivo de configuración modificado si se utiliza SSSD

(Opcional) Inicio de sesión único mediante tarjetas inteligentes

El inicio de sesión único (SSO) es una función de Citrix que implementa la autenticación de paso a través con inicios de escritorios y aplicaciones virtuales. Esta función reduce el número de veces que los usuarios escriben su PIN. Para usar el SSO con el VDA de Linux, configure la aplicación Citrix Workspace. La configuración es la misma que con el VDA de Windows. Para obtener más información, consulte el artículo de Knowledge Center CTX133982.
Habilite la autenticación con tarjeta inteligente de la siguiente manera al configurar la directiva de grupo en la aplicación Citrix Workspace.
Habilitar la autenticación con tarjeta inteligente en la aplicación Workspace

Inicio de sesión rápido con tarjeta inteligente

La tarjeta inteligente rápida es una mejora con respecto a la redirección de tarjeta inteligente HDX basada en PC/SC existente. Mejora el rendimiento cuando se utilizan tarjetas inteligentes en entornos WAN de alta latencia. Para obtener más información, consulte (/es-es/citrix-virtual-apps-desktops/secure/smart-cards.html).
El VDA de Linux admite tarjetas inteligentes rápidas en las siguientes versiones de la aplicación Citrix Workspace:
  • Citrix Receiver para Windows 4.12
  • Citrix Workspace app 1808 para Windows y versiones posteriores

Habilitar el inicio de sesión rápido con tarjeta inteligente en el cliente

El inicio de sesión rápido con tarjeta inteligente está habilitado de forma predeterminada en el VDA y deshabilitado de forma predeterminada en el cliente. En el cliente, para habilitar el inicio de sesión rápido con tarjeta inteligente, incluya el siguiente parámetro en el archivo default.ica del sitio de StoreFront asociado:
[WFClient]
SmartCardCryptographicRedirection=On

Deshabilitar el inicio de sesión rápido con tarjeta inteligente en el cliente

Para deshabilitar el inicio de sesión rápido con tarjeta inteligente en el cliente, elimine el parámetro SmartCardCryptographicRedirection del archivo default.ica del sitio de StoreFront asociado.

Uso

Iniciar sesión en el VDA de Linux mediante una tarjeta inteligente

Puede usar una tarjeta inteligente para iniciar sesión en el VDA de Linux tanto en escenarios de SSO como sin SSO.
  • En el escenario de SSO, inicia sesión en StoreFront™ automáticamente mediante el certificado de tarjeta inteligente y el PIN almacenados en caché. Al iniciar una sesión de escritorio virtual de Linux en StoreFront, el PIN se pasa al VDA de Linux para la autenticación con tarjeta inteligente.
  • En el escenario sin SSO, se le pedirá que seleccione un certificado e introduzca un PIN para iniciar sesión en StoreFront.
    Escribir un PIN para iniciar sesión en StoreFront
Cuando inicia una sesión de escritorio virtual Linux en StoreFront, aparece un cuadro de diálogo para iniciar sesión en el VDA de Linux, como se muestra a continuación. El nombre de usuario se extrae del certificado de la tarjeta inteligente y debe introducir el PIN de nuevo para la autenticación de inicio de sesión.
Este comportamiento es el mismo que con el VDA de Windows.
Autenticación de inicio de sesión

Volver a conectar a una sesión mediante una tarjeta inteligente

Para volver a conectar a una sesión, asegúrese de que la tarjeta inteligente esté conectada al dispositivo cliente. De lo contrario, aparecerá una ventana de almacenamiento en caché gris en el lado del VDA de Linux y se cerrará rápidamente porque la reautenticación falla si la tarjeta inteligente no está conectada. En este caso, no se proporciona ninguna otra indicación para recordarle que conecte la tarjeta inteligente.
Sin embargo, en el lado de StoreFront, si no hay una tarjeta inteligente conectada al intentar volver a conectar a una sesión, la web de StoreFront podría mostrar una alerta como la siguiente.
Imagen de inserción de una tarjeta inteligente

Limitación

Directiva de extracción de tarjetas inteligentes

Actualmente, el VDA de Linux solo utiliza el comportamiento predeterminado para la extracción de tarjetas inteligentes. Cuando se extrae la tarjeta inteligente después de iniciar sesión correctamente en el VDA de Linux, la sesión permanece conectada y la pantalla de la sesión no se bloquea.

Compatibilidad con otras tarjetas inteligentes y la biblioteca PKCS#11

Aunque solo la tarjeta inteligente OpenSC aparece en nuestra lista de compatibilidad, puede intentar usar otras tarjetas inteligentes y la biblioteca PKCS#11, ya que Citrix proporciona una solución genérica de redirección de tarjetas inteligentes. Para cambiar a su tarjeta inteligente específica o a la biblioteca PKCS#11:
  1. Sustituya todas las instancias de opensc-pkcs11.so por su biblioteca PKCS#11.
  2. Para establecer la ruta de su biblioteca PKCS#11 en el registro, ejecute el siguiente comando:
    /opt/Citrix/VDA/bin/ctxreg update -k "HKLM\System\CurrentControlSet\Control\Citrix\VirtualChannels\Scard" -v "PKCS11LibPath" -d "PATH"
    donde PATH apunta a su biblioteca PKCS#11, como /usr/lib64/pkcs11/opensc-pkcs11.so
  3. Deshabilitar el inicio de sesión rápido con tarjeta inteligente en el cliente.