Posodobitev vdelane programske opreme

V tem priročniku je opisano, kako posodobiti vdelano programsko opremo naprave Nitrokey 3.

Opozorilo

Ta vodnik je še vedno v poskusnem stanju!

Opomba

Posodobitve so mogoče samo z vdelano programsko opremo različice 0.11 in novejšo.

Pomembno

Posodobitev lahko povzroči izgubo podatkov, zato poskrbite, da imate omogočene ustrezne varnostne metode prijave in/ali da Nitrokey Pro ni edini način avtentikacije/2FA za vaše aplikacije/storitve.

Kako posodobiti

Pomembno

Med posodabljanjem nikoli ne odklopite naprave Nitrokey 3 ali prekinite postopka, saj bo naprava zaradi tega verjetno neuporabna!

  1. Prepričajte se, da imate nameščeno najnovejšo različico programa pynitrokey, preverite navodila za namestitev za svoj operacijski sistem.

  2. Prenesite najnovejšo stabilno sliko strojne programske opreme.

    Pomembno

    Za produkcijsko uporabo morate izbrati najnovejšo stabilno različico (torej samo različice, ki ne vsebujejo oznak „pre-release“ ali „RC“).

  3. Če želite uporabiti posodobitev, zaženite:

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

Alternativna metoda posodabljanja

Za posodobitev vdelane programske opreme lahko uporabite tudi dfu-util:

  1. Namestitev 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: Install dfu-util via Homebrew

    brew install dfu-util

  2. Z aplikacijo Nitrokey App v1.5-RC7 ali novejšo različico spremenite način zagona naprave Nitrokey Pro v način posodobitve.

  3. Za uporabo posodobitve uporabite naslednji ukaz

    $ dfu-util -D update_binary.bin

  4. Način zagona lahko zdaj znova spremenite z aplikacijo Nitrokey.

Odpravljanje težav

Issue: libnitrokey ni bilo mogoče najti.

Če knjižnice libnitrokey ni bilo mogoče najti samodejno, lahko pot do nje določite s spremenljivko env:

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

Za iskanje libnitrokey v sistemu uporabite:

$ locate libnitrokey.so

Linux Napaka pri dovoljenju

Problem: Med posodobitvijo dobim permission denied for /dev/hidrawX.

To verjetno pomeni, da vaš uporabnik nima potrebnih dovoljenj za branje in pisanje naprave. Prepričajte se, da ste pravilno nastavili udev-rules. Prenesite ta udev-rules in ga namestite v imenik s pravili udev (npr. /etc/udev/rules.d). Nato odstranite ključ Nitrokey 3 iz reže USB in zaženite: udevadm control --reload-rules && udevadm trigger ali ponovno zaženite računalnik. Nato bi morala posodobitev delovati brez težav z dovoljenji.