Firmware-päivitys#
Tässä oppaassa kuvataan, miten Nitrokey 3:n laiteohjelmisto päivitetään.
Varoitus
Tämä opas on vielä kokeiluvaiheessa!
Muista
Päivitykset ovat mahdollisia vain laiteohjelmiston versiolla 0.11 ja uudemmilla versioilla.
Tärkeä
Päivittäminen voi johtaa tietojen menetykseen, joten varmista, että sinulla on käytössäsi asianmukaiset varmuuskopiointikirjautumismenetelmät ja/tai varmista, että Nitrokey Pro ei ole ainoa tapa tunnistautua/2FA-sovelluksiisi/palveluihisi.
Kuinka päivittää#
Tärkeä
Älä koskaan irrota Nitrokey 3:a tai keskeytä prosessia päivityksen aikana, sillä tämä todennäköisesti tekee laitteestasi käyttökelvottoman!
Varmista, että sinulla on asennettuna uusin pynitrokey-versio, tarkista käyttöjärjestelmäsi asennusohjeet <../../software/nitropy/all-platforms/installation.html>`__.
Lataa uusin vakaa firmware-kuva.
Tärkeä
Tuotantokäyttöön kannattaa valita uusin vakaa versio (siis vain versiot, jotka eivät sisällä esimerkiksi ”pre-release” tai ”RC”).
Voit suorittaa päivityksen:
$ nitropy pro enable-update
$ nitropy pro update nitrokey-pro-firmware-<version>.bin
Vaihtoehtoinen päivitysmenetelmä#
Vaihtoehtoisesti laiteohjelmiston päivittämiseen voidaan käyttää dfu-util -ohjelmaa:
Asenna 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
vain macOS: Asenna dfu-util Homebrew:n kautta.
brew install dfu-util
Käytä Nitrokey App v1.5-RC7:ää tai uudempaa Nitrokey Pro -sovellusta vaihtaaksesi Nitrokey Pron käynnistystilan päivitystilaan.
Nyt seuraava komento soveltaa päivitystä
$ dfu-util -D update_binary.bin
Käynnistystilan voi nyt vaihtaa takaisin Nitrokey-sovelluksella.
Vianmääritys#
- Issue:
libnitrokey
ei löytynyt. Jos libnitrokey ei löydy automaattisesti, sen polku voidaan antaa muuttujalla env:
$ env LIBNK_PATH=/libnk/path/libnitrokey.so nitropy pro enable-update
Löydät libnitrokey:n järjestelmästäsi käyttämällä:
$ locate libnitrokey.so
Linuxin käyttöoikeusvirhe#
- Ongelma: Päivityksen aikana tulee
permission denied for /dev/hidrawX
. Tämä tarkoittaa todennäköisesti sitä, että käyttäjälläsi ei ole tarvittavia oikeuksia laitteen lukemiseen ja kirjoittamiseen. Varmista, että olet asettanut oikeat `udev-säännöt`_. Lataa tämä udev-rules-sarja ja sijoita se udev rules -hakemistoosi (esim.
/etc/udev/rules.d
). Irrota sitten Nitrokey 3 USB-korttipaikasta ja suorita:udevadm control --reload-rules && udevadm trigger
tai käynnistä kone uudelleen. Sen jälkeen päivityksen pitäisi toimia ilman lupaongelmaa.