Nitrokey 3とnitropyの併用について#

``nitropy``は、Nitrokey 3のデバイスを一覧表示して管理するために使用できます。

インストール#

pynitrokey のインストール方法については、` このガイド <https://docs.nitrokey.com/software/nitropy/all-platforms/installation>`__ を参照してください。

Nitrokey 3デバイスのリストアップ#

接続されているすべてのデバイスをリストアップするには、``nitropy list``または``nitropy nk3 list``を使用します。

$ 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

デバイス情報を問い合わせる#

現在、デバイス情報を照会するためのコマンドは以下の通りです。

  • nitropy nk3 version: デバイスのファームウェアバージョンを問い合わせる

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

複数のデバイスを操作する#

複数のNitrokey 3デバイスが接続されている場合は、``--path``を使用して、デバイスの1つを選択することができます。 デバイスのパスを決定するには、``nitropy list``または``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

トラブルシューティング#

Nitrokey 3デバイスの問題を診断するには、``nitropy nk3 test``コマンドを使用することができます。 このコマンドは、デバイスの状態を判断するためにいくつかのテストを行います。

テストが成功すると、手順の概要が印刷されます。

$ 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

テストが失敗した場合、エラーメッセージには、詳細な情報が記載されたログファイルのパスが含まれています。 サポートリクエストには、このログファイルを添付してください。

デバイスにFIDO2ピンを設定している場合は、``--pin``オプションを使用する必要があります。

$ nitropy nk3 test --pin 1234