Atualização do Firmware#

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 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