Firmware-päivitys#

(Nitrokey Pro 2 - Linux)

Tässä oppaassa kuvataan, miten Nitrokey 3:n laiteohjelmisto päivitetään.

Varoitus

Tämä opas on vielä kokeiluvaiheessa!

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!

  1. Varmista, että sinulla on asennettuna uusin pynitrokey-versio, tarkista käyttöjärjestelmäsi asennusohjeet <https://github.com/Nitrokey/pynitrokey#installation>`_.

  2. 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”).

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

  1. Asenna dfu-util

Binäärit Windowsille ovat saatavilla osoitteessa:
MacOS:lle binäärit ovat saatavilla Homebrew:n kautta:

vain macOS: Asenna dfu-util Homebrew:n kautta.

brew install dfu-util
  1. Käytä Nitrokey App v1.5-RC7:ää tai uudempaa Nitrokey Pro -sovellusta vaihtaaksesi Nitrokey Pron käynnistystilan päivitystilaan.

  2. Nyt seuraava komento soveltaa päivitystä

$ dfu-util -D update_binary.bin
  1. 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
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.