Püsivara uuendamine#

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

Hoiatus

See juhend on veel eksperimentaalses seisundis!

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

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

Binaarsed failid Windowsile on saadaval aadressil:
MacOS-i jaoks on binaarsed versioonid saadaval Homebrew’i kaudu:

macOS ainult: Paigaldage dfu-util Homebrew kaudu.

brew install dfu-util

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

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

$ dfu-util -D update_binary.bin

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