Актуализация на фърмуера#

(Nitrokey FIDO2 - Linux)

Това ръководство описва как да актуализирате фърмуера на Nitrokey 3.

Warning

Това ръководство все още е в експериментално състояние!

Important

Актуализацията може да доведе до загуба на данни, затова се уверете, че имате активирани подходящи методи за резервно влизане и/или се уверете, че Nitrokey Pro не е единственият начин за удостоверяване/2FA за вашите приложения/услуги.

Как да актуализирате#

Important

Никога не изключвайте Nitrokey 3 или не прекъсвайте процеса по време на актуализиране, защото това вероятно ще направи устройството ви безполезно!

  1. Уверете се, че имате инсталирана най-новата версия на pynitrokey, моля, проверете инструкциите за инсталиране <../../software/nitropy/all-platforms/installation.html>`__ за вашата операционна система.

  2. Изтеглете най-новото стабилно образа на фърмуера.

Important

За производствена употреба трябва да изберете последната стабилна версия (т.е. само версии, които не съдържат „pre-release“ или „RC“).

  1. За да приложите актуализацията, стартирайте:

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

Алтернативен метод за актуализация#

Алтернативно може да се използва dfu-util за актуализиране на фърмуера:

  1. Инсталиране на dfu-util

Двоичните файлове за Windows са налични на адрес:
За macOS двоичните файлове са налични чрез Homebrew:

само за MacOS: Инсталирайте dfu-util чрез Homebrew

brew install dfu-util
  1. Използвайте приложението Nitrokey App v1.5-RC7 или по-висока версия, за да промените режима на зареждане на Nitrokey Pro в режим на актуализация.

  2. Сега изпълнете следната команда, за да приложите актуализацията

$ dfu-util -D update_binary.bin
  1. Сега режимът на зареждане може да бъде променен отново с приложението Nitrokey.

Отстраняване на неизправности#

Проблем: libnitrokey не може да бъде намерен.

В случай че libnitrokey не бъде намерен автоматично, пътят до него може да бъде предоставен с променливата env:

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

За да намерите libnitrokey на вашата система, използвайте:

$ locate libnitrokey.so
Проблем: Получавам permission denied for /dev/hidrawX по време на актуализация.

Това вероятно означава, че вашият потребител няма необходимите разрешения за четене и запис на устройството. Уверете се, че сте настроили правилно udev-rules. Изтеглете този набор udev-rules и го поставете в директорията с правилата на udev (например /etc/udev/rules.d). След това извадете вашия Nitrokey 3 от USB слота и стартирайте: udevadm control --reload-rules && udevadm trigger или рестартирайте машината си. След това актуализацията би трябвало да работи без проблем с разрешенията.