Atualização do Firmware#

Este guia descreve como actualizar o firmware na Nitrokey 3.

Aviso

Este guia ainda se encontra num estado experimental!

Nota

As actualizações só são possíveis com a versão de firmware 0.11 e mais recente.

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»).

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

    Binaries for Windows are available at: * http://dfu-util.sourceforge.net/releases/

    For macOS binaries are available via Homebrew: * https://formulae.brew.sh/formula/dfu-util

    macOS only: Instalar dfu-util via Homebrew

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

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

    $ dfu-util -D update_binary.bin
    
  4. 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

Erro de permissão do Linux#

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.