Usando a Nitrokey 3 Com nitropia#

nitropy` pode ser usado para listar e gerir dispositivos Nitrokey 3.

Instalação#

Por favor ver ` este guia <https://docs.nitrokey.com/software/nitropy/all-platforms/installation>`__ para instruções de instalação da pynitrokey.

Listagem de dispositivos Nitrokey 3#

Use nitropy list` ou nitropy nk3 list para listar todos os 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

Informação do Dispositivo de Consulta#

Os seguintes comandos estão atualmente disponíveis para consulta de informações do dispositivo:

  • nitropy nk3 version: consulta a versão do firmware do dispositivo

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

Trabalhar com múltiplos dispositivos#

Se vários dispositivos Nitrokey 3 estiverem ligados, pode usar a opção --path para seleccionar um deles. Para determinar o caminho de um dispositivo, use o comando nitropy list` ou `x id="169"></x>`.

$ 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

Resolução de problemas#

Para diagnosticar problemas com seu dispositivo Nitrokey 3, você pode usar o comando nitropy nk3 test. Ele executa uma série de testes para determinar o estado do seu dispositivo.

Se os testes forem bem sucedidos, um resumo dos passos é impresso:

$ 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

Se um teste falhar, a mensagem de erro contém o caminho de um arquivo de log com informações detalhadas. Por favor, inclua este ficheiro de registo nos pedidos de suporte.

Se tiver definido um pino FIDO2 para o seu dispositivo, tem de usar a opção --pin:

$ nitropy nk3 test --pin 1234