Solución de problemas

Aquí encontrará una colección de problemas comunes.

Nitrokey no se detecta en Linux

Si no se detecta la Nitrokey, proceda como sigue:

  1. Copy this file 41-nitrokey.rules to /etc/udev/rules.d/.

  2. Reinicie udev a través de sudo service udev restart o udevadm control --reload-rules && udevadm trigger si utiliza Fedora.

El controlador del lector de tarjetas Nitrokey no se puede instalar en Windows

En Windows falla la inicialización del controlador genérico del lector de tarjetas inteligentes. El estado del dispositivo es This device is not working properly because Windows cannot load the drivers required for this device. (Code 31).

Windows dispone de dos controladores genéricos para lectores de tarjetas inteligentes (WUDF y UMDF2). Por defecto Windows utiliza UMDF2, que falla al inicializarse y por lo tanto no se carga para el Nitrokey.

Para garantizar una inicialización correcta del controlador, añada un reintento para la inicialización del dispositivo. En el registro, añada la siguiente clave de registro.

Path: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography\Calais\Readers
Ruta: <x id=»6»></x>`<x id=»8»></x><x id=»73»></x>`
Tipo: DWORD (32-bit)
Datos: 1

Nota

La clave de registro está disponible para Windows 10 (versión 1903 (19H1) y posteriores) y Windows 11.

Si el lector de tarjetas inteligentes ya estaba instalado anteriormente con una inicialización fallida puede que tenga que eliminarlo del registro. En el registro elimine la siguiente ruta de registro.

Path: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography\Calais\Readers\Nitrokey CCID/ICCD Interface 0

Si el lector de tarjetas inteligentes se instaló varias veces anteriormente, puede haber más de una ruta con un número incrementado al final.

Después de un reinicio el Nitrokey es reconocido como Microsoft Usbccid Smartcard Reader (WUDF).

Servicios de Google y Microsoft

Actualmente parece haber un error que esperamos solucionar pronto y que afecta al funcionamiento de Nitrokey 3 con algunos servicios de Google y Microsoft por FIDO2.

Error de tiempo de espera

Hay un error en el reconocimiento de la Nitrokey por el sistema, donde se produce un tiempo de espera antes de que la conexión tenga éxito.

NFC no funciona

Asegúrese de que FIDO2 funciona correctamente. De lo contrario, NFC tampoco funcionará.

Also check if you are using the right spot on your smartphone.

La parte trasera de la Nitrokey debe mantenerse contra el smartphone. Para la versión USB-A puede ser útil levantar ligeramente el lado con el conector USB para reducir la distancia hasta la parte final del stick.

Si tienes una funda para el teléfono, intenta encontrar primero el punto correcto sin ella. Vuelve a intentarlo después con la funda.

La búsqueda del punto óptimo a veces duraba hasta 20-30 segundos. En nuestra experiencia, mantener el Nitrokey en una orientación horizontal produce mejores resultados. Para una ayuda óptima, incluya el número de envío/pedido y su modelo de smartphone.

Solución de problemas de OpenPGP

GnuPG: Tarjeta OpenPGP no disponible

Problema: GnuPG no puede acceder al Nitrokey 3 y muestra un mensaje de error como este:

$ gpg --card-status
gpg: selecting openpgp failed: No such device
gpg: OpenPGP card not available: No such device

Solución: Hay dos servicios de tarjeta inteligente comunes en los sistemas Linux: scdaemon, el demonio de tarjeta inteligente de GnuPG, y pcscd, un demonio de tarjeta inteligente genérico. scdaemon ` tiene dos controladores para acceder a las tarjetas inteligentes: Su controlador integrado ccid intenta acceder directamente a la tarjeta inteligente. El controlador pcsc utiliza el demonio pcscd en su lugar.

Sólo un demonio puede acceder directamente a una tarjeta inteligente. Esto significa que dependiendo del orden de arranque, pcscd podría bloquear la tarjeta antes de que scdaemon intente acceder a ella usando el driver interno ccid. Por lo tanto, recomendamos utilizar el controlador pcscd para scdaemon. Puede activarlo añadiendo disable-ccid al archivo de configuración ~/.gnupg/scdaemon.conf y reiniciando scdaemon, por ejemplo con gpg-connect-agent "SCD KILLSCD" /bye. Si esto no soluciona el problema, consulte la siguiente sección para obtener más información.

Alternativamente, puede desactivar o desinstalar pcscd para evitar este conflicto.

pcscd: Tarjeta no encontrada

Problema: Una aplicación que utiliza pcscd no muestra la Nitrokey 3.

Solución: En primer lugar, asegúrese de que scdaemon no se está ejecutando (véase la sección anterior):

$ gpg-connect-agent "SCD KILLSCD" /bye

Ahora liste las smartcards reconocidas por pcscd con pcsc_scan -r. Deberías ver una entrada como esta:

$ pcsc_scan -r
Using reader plug'n play mechanism
Scanning present readers..
0: Nitrokey 3 [CCID/ICCD Interface] 00 00

Si el Nitrokey 3 aparece, es que es reconocido correctamente por pcscd y puede haber un problema con la aplicación que intenta acceder a él. Si no aparece, asegúrese de que su versión de libccid está actualizada. La compatibilidad con Nitrokey 3 se añadió en libccid 1.5.0.

Actualización de la base de datos de dispositivos

Si no puede actualizar libccid a una versión compatible, deberá actualizar manualmente la base de datos de dispositivos. La ruta de la base de datos depende de su distribución:

  • Arch, Debian, Ubuntu: /etc/libccid_Info.plist

Asegúrese de hacer una copia de seguridad del archivo antes de sobrescribirlo. Puede descargar un archivo de base de datos de dispositivos actualizado del repositorio nitrokey-3-firmware. Después de actualizar el archivo, reinicie pcscd y ejecute pcsc_scan -r de nuevo. Ahora debería aparecer el Nitrokey 3.

La actualización a través de update.nitrokey.com no funciona

Actualmente el actualizador web no es compatible con el Nitrokey 3. Sin embargo, puede obtener el último firmware utilizando estas instrucciones de .

PIV Troubleshooting

Pyscard is not available

If pyscard is not available to nitropy, you might get the following error when trying to use the PIV functionality:

This command requires the pyscard library that is not available on your system. Please consult https://docs.nitrokey.com/nitrokeys/nitrokey3/troubleshooting#pyscard-is-not-available for more information

To fix this error, please install nitropy with the pcsc extra dependencies:

pip install pynitrokey[pcsc]
pipx install pynitrokey[pcsc]

Si instala pynitrokey a través de otro canal de distribución, instale todas las dependencias opcionales para este canal.