Aggiornamento del firmware#

Questa guida descrive come aggiornare il firmware di Nitrokey Pro.

Avvertimento

Questa guida è ancora in stato sperimentale!

Importante

L’aggiornamento potrebbe comportare la perdita di dati, quindi assicuratevi di aver attivato metodi di login di backup adeguati e/o assicuratevi che Nitrokey Pro non sia l’unico modo di autenticare/2FA per le vostre applicazioni/servizi.

Come aggiornare#

Importante

Non scollegare mai Nitrokey Pro o interrompere il processo durante l’aggiornamento, per non rendere inutilizzabile il dispositivo!

  1. Assicurarsi di avere installato l’ultima versione di pynitrokey, controllare le istruzioni di installazione per il proprio sistema operativo.

  2. Scaricare l’ultima immagine firmware stabile ` <https://github.com/Nitrokey/nitrokey-pro-firmware/releases>`__.

Importante

Per l’uso in produzione si dovrebbe scegliere l’ultima versione stabile (quindi solo le versioni che non contengono «pre-release» o «RC»).

  1. Per applicare l’aggiornamento, eseguire:

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

Metodo di aggiornamento alternativo#

In alternativa si può usare dfu-util per l’aggiornamento del firmware:

  1. Installare dfu-util

I binari per Windows sono disponibili all’indirizzo:
Per macOS i binari sono disponibili tramite Homebrew:

Solo MacOS: Installare dfu-util tramite Homebrew

brew install dfu-util
  1. Utilizzare Nitrokey App v1.5-RC7 o superiore per modificare la modalità di avvio di Nitrokey Pro in modalità di aggiornamento.

  2. Ora eseguite il seguente comando per applicare l’aggiornamento

$ dfu-util -D update_binary.bin
  1. La modalità di avvio può essere nuovamente modificata con l’app Nitrokey.

Risoluzione dei problemi#

Issue: libnitrokey non è stato trovato.

Nel caso in cui la libnitrokey non venga trovata automaticamente, il percorso può essere fornito con la variabile env:

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

Per trovare libnitrokey sul proprio sistema, utilizzare:

$ locate libnitrokey.so
Problema: Ottengo permission denied for /dev/hidrawX durante l’aggiornamento.

Questo probabilmente significa che l’utente non ha i permessi necessari per leggere/scrivere il dispositivo. Assicurarsi di aver impostato correttamente udev-rules. Scaricate questo set udev-rules e inseritelo nella vostra directory udev rules (ad esempio, /etc/udev/rules.d). Quindi rimuovete Nitrokey Pro dallo slot USB ed eseguite: udevadm control --reload-rules && udevadm trigger o riavviare il computer. In seguito l’aggiornamento dovrebbe funzionare senza il problema dei permessi.