Utilisation de la Nitrokey 3 avec nitropy#

nitropy peut être utilisé pour lister et gérer les périphériques Nitrokey 3.

Installation#

Veuillez consulter ce guide pour les instructions d’installation de pynitrokey.

Liste des dispositifs Nitrokey 3#

Utilisez nitropy list ou nitropy nk3 list pour répertorier tous les périphériques connectés :

$ 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

Interrogation des informations sur le dispositif#

Les commandes suivantes sont actuellement disponibles pour interroger les informations sur les périphériques :

  • nitropy nk3 version : demande la version du firmware du dispositif

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

Travailler avec plusieurs appareils#

Si plusieurs dispositifs Nitrokey 3 sont connectés, vous pouvez utiliser l’option --path pour en sélectionner un. Pour déterminer le chemin d’un périphérique, utilisez la commande nitropy list ou 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

Dépannage#

Pour diagnostiquer les problèmes de votre dispositif Nitrokey 3, vous pouvez utiliser la commande nitropy nk3 test. Elle effectue un certain nombre de tests pour déterminer l’état de votre appareil.

Si les tests sont réussis, un résumé des étapes est imprimé :

$ 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 un test échoue, le message d’erreur contient le chemin d’accès à un fichier journal contenant des informations détaillées. Veuillez inclure ce fichier journal dans vos demandes d’assistance.

Si vous avez défini une broche FIDO2 pour votre appareil, vous devez utiliser l’option --pin :

$ nitropy nk3 test --pin 1234