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

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

Warning

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

Note

Актуализациите са възможни само с версия на фърмуера 0.11 и по-нова.

Important

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

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

Important

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

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

Important

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

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

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

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

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

Инсталиране на dfu-util
- Binaries for Windows are available here
- За macOS двоичните файлове са налични чрез Homebrew и могат да бъдат инсталирани чрез изпълнение на:
```
brew install dfu-util
```
Използвайте приложението Nitrokey App v1.5-RC7 или по-висока версия, за да промените режима на зареждане на Nitrokey Pro в режим на актуализация.
Сега изпълнете следната команда, за да приложите актуализацията
```
$ dfu-util -D update_binary.bin
```
Сега режимът на зареждане може да бъде променен отново с приложението Nitrokey.

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

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

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

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

$ locate libnitrokey.so

Грешка в разрешението на Linux¶

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