Atualização do Firmware#

(Nitrokey Pro 2 - Linux)

Este guia descreve como actualizar o firmware na Nitrokey 3.

Aviso

Este guia ainda se encontra num estado experimental!

Importante

A actualização pode levar à perda de dados, por isso certifique-se de que tem os métodos de login de reserva adequados activados e/ou assegure-se de que o Nitrokey Pro não é a única forma de autenticar/2FA para as suas aplicações/serviços.

Como atualizar#

Importante

Nunca desconecte a Nitrokey 3 ou aborte o processo durante a atualização, isso provavelmente tornará seu aparelho inútil!

  1. Certifique-se de que tem instalada a última versão pynitrokey, por favor verifique as instruções de instalação <https://github.com/Nitrokey/pynitrokey#installation>`_ para o seu sistema operativo.

  2. Descarregar a última imagem estável firmware.

Importante

Para utilização na produção deve escolher a última versão estável (por isso só as versões que não contenham i.e. «pré-lançamento» ou «RC»).

  1. Para aplicar a execução de actualização:

$ nitropy pro enable-update
$ nitropy pro update nitrokey-pro-firmware-<version>.bin

Método alternativo de actualização#

Alternativamente dfu-util pode ser utilizado para a actualização do firmware:

  1. Instalar dfu-util

Os binários para Windows estão disponíveis em:
Para macOS binários estão disponíveis via homebrew:

macOS only: Instalar dfu-util via Homebrew

brew install dfu-util
  1. Use Nitrokey App v1.5-RC7 ou superior para mudar o modo de arranque do Nitrokey Pro para o modo de actualização.

  2. Agora o seguinte comando para aplicar a actualização

$ dfu-util -D update_binary.bin
  1. O modo de arranque pode agora ser novamente alterado com a aplicação Nitrokey.

Resolução de problemas#

Issue: libnitrokey não pôde ser encontrado.

Caso a libnitrokey não possa ser encontrada automaticamente, o caminho para ela pode ser fornecido com a variável env:

$ env LIBNK_PATH=/libnk/path/libnitrokey.so nitropy pro enable-update

Para encontrar libnitrokey na utilização do seu sistema:

$ locate libnitrokey.so
Issue: Eu recebo permission denied for /dev/hidrawX durante a atualização.

Isso provavelmente significa que seu usuário não tem as permissões necessárias para ler-escrever o dispositivo. Por favor, certifique-se de que você configurou o correto udev-rules. Faça o download deste udev-rules set e coloque-o no seu directório de regras udev (por exemplo, /etc/udev/rules.d`). Depois retire o seu Nitrokey 3 da ranhura USB e execute: udevadm control --reload-rules && udevadm trigger` ou reinicie a sua máquina. Depois disso a atualização deve funcionar sem a emissão da permissão.