Actualizarea firmware-ului

Acest ghid descrie modul de actualizare a firmware-ului de pe Nitrokey 3.

Atenționare

Acest ghid este încă în stare experimentală!

Notă

Actualizările sunt posibile numai cu versiunea firmware 0.11 și mai recente.

Important

Actualizarea ar putea duce la pierderea de date, așa că asigurați-vă că aveți activate metode de autentificare de rezervă adecvate și/sau asigurați-vă că Nitrokey Pro nu este singura modalitate de autentificare/2FA pentru aplicațiile/serviciile dvs.

Cum se actualizează

Important

Nu deconectați niciodată Nitrokey 3 sau nu întrerupeți procesul în timpul actualizării, deoarece acest lucru va face ca dispozitivul să devină inutilizabil!

  1. Asigurați-vă că aveți instalată cea mai recentă versiune pynitrokey, vă rugăm să verificați instrucțiunile de instalare pentru sistemul dumneavoastră de operare.

  2. Descărcați cea mai recentă imagine stabilă firmware.

    Important

    Pentru utilizarea în producție trebuie să alegeți cea mai recentă versiune stabilă (deci numai versiunile care nu conțin „pre-release” sau „RC”).

  3. Pentru a aplica actualizarea, executați:

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

Metoda alternativă de actualizare

Alternativ, se poate utiliza dfu-util pentru actualizarea firmware-ului:

  1. Instalați 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

    Doar MacOS: Instalați dfu-util prin Homebrew

    brew install dfu-util

  2. Utilizați Nitrokey App v1.5-RC7 sau o versiune mai recentă pentru a schimba modul de pornire al Nitrokey Pro în modul de actualizare.

  3. Acum următoarea comandă pentru a aplica actualizarea

    $ dfu-util -D update_binary.bin

  4. Modul de pornire poate fi acum schimbat din nou cu ajutorul aplicației Nitrokey.

Depanare

Issue: libnitrokey` nu a putut fi găsit.

În cazul în care libnitrokey nu a putut fi găsită automat, calea de acces la aceasta poate fi furnizată prin variabila env:

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

Pentru a găsi libnitrokey pe sistemul dvs. utilizați:

$ locate libnitrokey.so

Eroare de permisiune Linux

Problemă: Primesc permission denied for /dev/hidrawX în timpul actualizării.

Acest lucru înseamnă probabil că utilizatorul dvs. nu are permisiunile necesare pentru a citi-scrie pe dispozitiv. Vă rugăm să vă asigurați că ați configurat corect udev-rules. Descărcați acest set udev-rules și plasați-l în directorul dvs. de reguli udev (de exemplu, /etc/udev/rules.d). Apoi scoateți Nitrokey 3 din slotul USB și rulați: `udevadm control --reload-rules && udevadm trigger sau reporniți mașina. Ulterior, actualizarea ar trebui să funcționeze fără problema de permisiune.