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!

  1. Varmista, että sinulla on asennettuna uusin pynitrokey-versio, tarkista käyttöjärjestelmäsi asennusohjeet <../../software/nitropy/all-platforms/installation.html>`__.

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

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

    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
    
  2. Käytä Nitrokey App v1.5-RC7:ää tai uudempaa Nitrokey Pro -sovellusta vaihtaaksesi Nitrokey Pron käynnistystilan päivitystilaan.

  3. Nyt seuraava komento soveltaa päivitystä

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