Aktualizace firmwaru#

Tento návod popisuje, jak aktualizovat firmware zařízení Nitrokey 3.

Varování

Tento průvodce je stále v experimentálním stavu!

Důležité

Aktualizace by mohla vést ke ztrátě dat, proto se ujistěte, že máte povoleny správné záložní metody přihlašování a/nebo zajistěte, aby Nitrokey Pro nebyl jediným způsobem ověřování/2FA pro vaše aplikace/služby.

Jak aktualizovat#

Důležité

Během aktualizace nikdy neodpojujte Nitrokey 3 ani nepřerušujte proces, protože by se tím zařízení pravděpodobně stalo nepoužitelným!

  1. Ujistěte se, že máte nainstalovanou nejnovější verzi pynitrokey, zkontrolujte prosím instalační pokyny pro váš operační systém.

  2. Stáhněte si nejnovější stabilní obraz firmwaru.

Důležité

Pro produkční použití byste měli zvolit nejnovější stabilní verzi (tedy pouze verze, které neobsahují označení „pre-release“ nebo „RC“).

  1. Chcete-li použít aktualizaci, spusťte:

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

Alternativní metoda aktualizace#

Alternativně lze pro aktualizaci firmwaru použít dfu-util:

  1. Instalace dfu-util

Binární soubory pro Windows jsou k dispozici na adrese:
Pro macOS jsou binární soubory k dispozici prostřednictvím Homebrew:

pouze pro MacOS: Nainstalujte dfu-util přes Homebrew

brew install dfu-util

  1. Pomocí aplikace Nitrokey App v1.5-RC7 nebo vyšší můžete změnit režim spouštění zařízení Nitrokey Pro na režim aktualizace.

  2. Nyní použijte následující příkaz pro použití aktualizace

$ dfu-util -D update_binary.bin

  1. Režim spouštění lze nyní opět změnit pomocí aplikace Nitrokey.

Řešení problémů#

Problém: libnitrokey se nepodařilo najít.

V případě, že libnitrokey nebyl nalezen automaticky, lze cestu k němu zadat pomocí proměnné env:

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

Pro nalezení libnitrokey v systému použijte:

$ locate libnitrokey.so
Problém: Při aktualizaci se mi zobrazí permission denied for /dev/hidrawX.

To pravděpodobně znamená, že váš uživatel nemá potřebná oprávnění ke čtení a zápisu zařízení. Ujistěte se, že jste nastavili správná udev-rules. Stáhněte si tuto sadu udev-rules a umístěte ji do adresáře udev rules (např. /etc/udev/rules.d). Poté vyjměte klíč Nitrokey 3 ze slotu USB a spusťte jej: udevadm control --reload-rules && udevadm trigger nebo restartujte počítač. Poté by měla aktualizace fungovat bez problému s oprávněním.