Verwendung des Nitrokey 3 mit Nitropy#

nitropy kann verwendet werden, um Nitrokey 3 Geräte aufzulisten und zu verwalten.

Installation#

Bitte lesen Sie diese Anleitung für die Installationsanweisungen von pynitrokey.

Auflistung der Nitrokey 3 Geräte#

Verwenden Sie nitropy list oder nitropy nk3 list, um alle angeschlossenen Geräte aufzulisten:

$ 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

Abfrage von Geräteinformationen#

Die folgenden Befehle sind derzeit für die Abfrage von Geräteinformationen verfügbar:

  • nitropy nk3 version: fragt die Firmware-Version des Geräts ab

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

Arbeiten mit mehreren Geräten#

Wenn mehrere Nitrokey 3 Geräte angeschlossen sind, können Sie mit der Option --path eines davon auswählen. Um den Pfad eines Gerätes zu ermitteln, verwenden Sie den Befehl nitropy list oder 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

Fehlersuche#

Um Probleme mit Ihrem Nitrokey 3-Gerät zu diagnostizieren, können Sie den Befehl nitropy nk3 test verwenden. Er führt eine Reihe von Tests durch, um den Zustand Ihres Geräts zu ermitteln.

Wenn die Tests erfolgreich verlaufen sind, wird eine Zusammenfassung der Schritte ausgedruckt:

$ 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

Wenn ein Test fehlschlägt, enthält die Fehlermeldung den Pfad zu einer Protokolldatei mit detaillierten Informationen. Bitte geben Sie diese Protokolldatei bei Supportanfragen an.

Wenn Sie einen FIDO2-Pin für Ihr Gerät festgelegt haben, müssen Sie die Option --pin verwenden:

$ nitropy nk3 test --pin 1234