Aggiornamento del firmware

Questa guida descrive come aggiornare il firmware di Nitrokey Pro.

Avvertimento

Questa guida è ancora in stato sperimentale!

Nota

Gli aggiornamenti sono possibili solo con la versione firmware 0.11 e successive.

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

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

    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

    Solo MacOS: Installare dfu-util tramite Homebrew

    brew install dfu-util

  2. Utilizzare Nitrokey App v1.5-RC7 o superiore per modificare la modalità di avvio di Nitrokey Pro in modalità di aggiornamento.

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

    $ dfu-util -D update_binary.bin

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

Errore di autorizzazione di Linux

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.