Firmware bijwerken

Deze handleiding beschrijft hoe u de firmware van de Nitrokey Pro bijwerkt.

Waarschuwing

Deze gids is nog in een experimentele staat!

Notitie

Updates zijn alleen mogelijk met firmwareversie 0.11 en nieuwer.

Belangrijk

Updaten kan leiden tot gegevensverlies, dus zorg ervoor dat u de juiste back-up inlogmethoden hebt ingeschakeld en/of zorg ervoor dat de Nitrokey Pro niet de enige manier van authenticatie/2FA is voor uw toepassingen/diensten.

Hoe bij te werken

Belangrijk

Koppel de Nitrokey Pro nooit los en breek het proces nooit af tijdens het updaten, hierdoor zal uw apparaat waarschijnlijk onbruikbaar worden!

  1. Zorg ervoor dat u de laatste pynitrokey-versie hebt geïnstalleerd, controleer de installatie-instructies voor uw OS.

  2. Download de laatste stabiele firmware image.

    Belangrijk

    Voor productie gebruik zou u de laatste stabiele versie moeten kiezen (dus alleen versies, die niet “pre-release” of “RC” bevatten).

  3. Om de update toe te passen, voer uit:

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

Alternatieve bijwerkingsmethode

Als alternatief kan dfu-util worden gebruikt voor de firmware update:

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

    alleen MacOS: Installeer dfu-util via Homebrew

    brew install dfu-util

  2. Gebruik Nitrokey App v1.5-RC7 of hoger om de opstartmodus van de Nitrokey Pro in update modus te veranderen.

  3. Voer nu het volgende commando uit om de update toe te passen

    $ dfu-util -D update_binary.bin

  4. De opstartmodus kan nu weer worden gewijzigd met de Nitrokey App.

Problemen oplossen

Issue: libnitrokey kon niet worden gevonden.

In het geval dat libnitrokey niet automatisch gevonden kan worden, kan het pad ernaartoe opgegeven worden met env. variabele:

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

Om libnitrokey op uw systeem te vinden gebruikt u:

$ locate libnitrokey.so

Linux toestemmingsfout

Issue: Ik krijg permission denied for /dev/hidrawX tijdens het updaten.

Dit betekent waarschijnlijk dat uw gebruiker niet de benodigde permissies heeft om het apparaat te lezen/schrijven. Zorg ervoor dat u de juiste udev-rules heeft ingesteld. Download deze udev-rules set en plaats ze in uw udev rules directory (bv. /etc/udev/rules.d). Verwijder vervolgens uw Nitrokey Pro uit de USB-sleuf en voer het volgende uit: udevadm control --reload-rules && udevadm trigger of start uw machine opnieuw op. Daarna zou de update moeten werken zonder het toestemmingsprobleem.