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!
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.
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»).
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:
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
Use Nitrokey App v1.5-RC7 ou superior para mudar o modo de arranque do Nitrokey Pro para o modo de actualização.
Agora o seguinte comando para aplicar a actualização
$ dfu-util -D update_binary.bin
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.