Püsivara uuendamine

Selles juhendis kirjeldatakse, kuidas Nitrokey 3 püsivara uuendada.

Hoiatus

See juhend on veel eksperimentaalses seisundis!

Märkus

Uuendused on võimalikud ainult püsivara versiooniga 0.11 ja uuemate versioonidega.

Tähtis

Uuendamine võib põhjustada andmekaotust, seega veenduge, et teil on lubatud nõuetekohased varusisselogimismeetodid ja/või veenduge, et Nitrokey Pro ei ole ainus viis teie rakenduste/teenuste autentimiseks/2FA.

Kuidas uuendada

Tähtis

Ärge kunagi ühendage Nitrokey 3 lahti või katkestage protsessi uuendamise ajal, see muudab teie seadme tõenäoliselt kasutamiskõlbmatuks!

  1. Veenduge, et teil on paigaldatud uusim pynitrokey versioon, palun vaadake installeerimisjuhiseid teie operatsioonisüsteemi jaoks.

  2. Laadige alla uusim stabiilne firmware image.

    Tähtis

    Tootmiskasutuseks tuleks valida uusim stabiilne versioon (seega ainult versioonid, mis ei sisalda näiteks „pre-release“ või „RC“).

  3. Uuenduse rakendamiseks käivitage:

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

Alternatiivne ajakohastusmeetod

Alternatiivina võib kasutada dfu-util firmware uuendamiseks:

  1. Paigaldage 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 ainult: Paigaldage dfu-util Homebrew kaudu.

    brew install dfu-util

  2. Kasutage Nitrokey App v1.5-RC7 või uuemat versiooni, et muuta Nitrokey Pro alglaadimisrežiim uuendusrežiimile.

  3. Nüüd järgmine käsk uuenduse rakendamiseks

    $ dfu-util -D update_binary.bin

  4. Käivitusrežiimi saab nüüd Nitrokey rakendusega taas tagasi muuta.

Veaotsing

Issue: libnitrokey<x> ei leitud.

Kui libnitrokey’t ei ole võimalik automaatselt leida, võib selle tee esitada muutujaga env:

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

Libnitrokey leidmiseks teie süsteemis kasutage:

$ locate libnitrokey.so

Linuxi lubade viga

Küsimus: Ma saan permission denied for /dev/hidrawX uuendamise ajal.

See tähendab tõenäoliselt, et teie kasutajal ei ole seadme lugemiseks-kirjutamiseks vajalikke õigusi. Veenduge, et olete seadistanud õiged udev-rules. Laadige see udev-rules komplekt alla ja paigutage see oma udev reeglite kataloogi (nt /etc/udev/rules.d). Seejärel eemaldage oma Nitrokey 3 USB-pesast ja käivitage: udevadm control --reload-rules && udevadm trigger või taaskäivitage oma masin. Pärast seda peaks värskendus toimima ilma lubade probleemita.