Использование Nitrokey 3 с nitropy¶
nitropy можно использовать для списка и управления устройствами Nitrokey 3.
Установка¶
Пожалуйста, смотрите это руководство для инструкций по установке pynitrokey.
Перечисление устройств 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 для выбора одного из них. Чтобы определить путь устройства, используйте команду 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