Uso de Nitrokey 3 con nitropy#

nitropy se puede utilizar para listar y gestionar los dispositivos Nitrokey 3.

Instalación#

Por favor, consulte esta guía para las instrucciones de instalación de pynitrokey.

Listado de dispositivos Nitrokey 3#

Utilice nitropy list o nitropy nk3 list para enumerar todos los dispositivos conectados:

$ nitropy list
Nitrokey tool for Nitrokey FIDO2, Nitrokey Start, Nitrokey 3 & NetHSM
:: 'Nitrokey FIDO2' keys
:: 'Nitrokey Start' keys:
:: 'Nitrokey 3' keys
/dev/hidraw3: Nitrokey 3

$ nitropy nk3 list
Nitrokey tool for Nitrokey FIDO2, Nitrokey Start, Nitrokey 3 & NetHSM
:: 'Nitrokey 3' keys
/dev/hidraw3: Nitrokey 3

Consulta de la información del dispositivo#

Los siguientes comandos están actualmente disponibles para consultar la información del dispositivo:

  • nitropy nk3 version: consulta la versión del firmware del dispositivo.

    $ nitropy nk3 version
Nitrokey tool for Nitrokey FIDO2, Nitrokey Start, Nitrokey 3 & NetHSM
v1.0.0

Trabajar con varios dispositivos#

Si hay varios dispositivos Nitrokey 3 conectados, puede utilizar la opción --path para seleccionar uno de ellos. Para determinar la ruta de un dispositivo, utilice el comando nitropy list o nitropy nk3 list.

$ nitropy nk3 version
Nitrokey tool for Nitrokey FIDO2, Nitrokey Start, Nitrokey 3 & NetHSM
Error: Multiple Nitrokey 3 devices found -- use the --path option to select one

$ nitropy nk3 list
Nitrokey tool for Nitrokey FIDO2, Nitrokey Start, Nitrokey 3 & NetHSM
:: 'Nitrokey 3' keys
/dev/hidraw4: Nitrokey 3 DD59A7F00CCB715DB515F83C346CA8AD
/dev/hidraw3: Nitrokey 3

$ nitropy nk3 --path /dev/hidraw3 version
Nitrokey tool for Nitrokey FIDO2, Nitrokey Start, Nitrokey 3 & NetHSM
v1.0.0

$ nitropy nk3 --path /dev/hidraw4 version
Nitrokey tool for Nitrokey FIDO2, Nitrokey Start, Nitrokey 3 & NetHSM
v1.0.1

Solución de problemas#

Para diagnosticar problemas con su dispositivo Nitrokey 3, puede utilizar el comando nitropy nk3 test. Realiza una serie de pruebas para determinar el estado de su dispositivo.

Si las pruebas son exitosas, se imprime un resumen de los pasos:

$ nitropy nk3 test
Nitrokey tool for Nitrokey FIDO2, Nitrokey Start, Nitrokey 3 & NetHSM
Found 1 Nitrokey 3 device(s):
- Nitrokey 3 at /dev/hidraw3

Running tests for Nitrokey 3 at /dev/hidraw3

[1/3]   UUID query                      SUCCESS         [not supported]
[2/3]   Firmware version query          SUCCESS         v1.0.0
Please press the touch button on the device ...
Please press the touch button on the device ...
[3/3]   FIDO2                           SUCCESS

3 tests, 3 successful, 0 skipped, 0 failed

Summary: 1 device(s) tested, 1 successful, 0 failed

Si una prueba falla, el mensaje de error contiene la ruta de un archivo de registro con información detallada. Incluya este archivo de registro en las solicitudes de asistencia.

Si has establecido un pin FIDO2 para tu dispositivo, tienes que utilizar la opción --pin:

$ nitropy nk3 test --pin 1234