Programmatūras atjaunināšana

Šajā rokasgrāmatā aprakstīts, kā atjaunināt Nitrokey 3 programmaparatūru.

Svarīgi

Programmatūras v.1.0.0 un jaunākām versijām atjauninājums izdzēsīs visus lietotāja datus! Pārliecinieties, ka ir iespējotas atbilstošas rezerves pieteikšanās metodes un/vai pārliecinieties, ka Nitrokey 3 nav vienīgais autentifikācijas/2FA veids jūsu lietojumprogrammām/pakalpojumiem.

Programmaparatūras v1.0.1 un jaunākās versijas lietotāja dati tiek saglabāti atjaunināšanas laikā. Jebkurā gadījumā, ja kāda iemesla dēļ jūsu dati netiek saglabāti, pārliecinieties, ka pakalpojumā vienmēr ir reģistrēta cita ierīce (vai pieteikšanās metode).

Kā atjaunināt

Svarīgi

Nekad neatvienojiet Nitrokey 3 vai nepārtrauciet procesu atjaunināšanas laikā, jo tas, iespējams, padarīs ierīci nederīgu!

1. Pārliecinieties, ka ir instalēta jaunākā pynitrokey versija, lūdzu, skatiet instalēšanas instrukcijas savai operētājsistēmai.

2. Palaist nitropy nk3 update.

3. Pēc norādījuma nitropy pieskarieties ierīcei, lai aktivizētu bootloader.

4. tikai operētājsistēmai MacOS: Ja ir norādīts nitropy, vēlreiz izpildiet atjaunināšanas komandu.

5. Lūdzu, pagaidiet, līdz process tiks pabeigts. (Tas var atšķirties atkarībā no jūsu operētājsistēmas).

6. Vienreizējs: palaist nitropy nk3 test, lai pārbaudītu, vai ierīce pēc mirgošanas darbojas pareizi.

Kļūdu gadījumā, lūdzu, ņemiet žurnālus no </x id="50"></x> direktorijas (/tmp/nitropy.log.*).

Programmatūras versiju tipi

Nitrokey 3 ir trīs veidu programmaparatūras versijas:

Lietotājiem vissvarīgākais ir stabilas versijas. Tās ir izstrādātas tā, lai tās būtu savietojamas ar iepriekšējo versiju un saglabātu visus lietotāja datus, un ir rūpīgi pārbaudītas. Ražošanas ierīcēs jāizmanto tikai stabilās versijas.

izlaides kandidāts ir gaidāmās stabilās versijas priekšskatījums. Tai vajadzētu būt arī atpakaļsaderīgai, taču tā nav tik rūpīgi pārbaudīta kā stabilā versija.

Testa versijas (iepriekš: alfa versijas) satur papildu funkcijas, kas vēl nav gatavas lietošanai ražošanā. Lietotāja dati, kas izveidoti ar testa versiju, var nebūt saderīgi ar citām versijām. Šīs versijas joprojām tiek testētas, un tajās, visticamāk, būs kļūdas.

Lai iegūtu vairāk informācijas par izdevumā pieejamajām funkcijām, skatiet release notes vietnē GitHub.

Programmaparatūras versijas tipu var noteikt pēc tās versijas numura:

Tips	Versijas numurs	Piemērs
stabila izlaide	v<major>.<minor>.<patch>	v1.3.1
izlaišanas kandidāts	v<major>.<minor>.<patch>-rc.<counter>	v1.3.1-rc.1
testa izlaidums	v<major>.<minor>.<patch>-test.<date>	v1.3.1-test.20230414

Aizsardzība pret pazeminātu kategoriju

Nitrokey 3 programmaparatūru nav iespējams atjaunināt. Varat instalēt tikai tādu pašu vai lielāku programmaparatūras atjauninājumu ar tādu pašu vai lielāku versijas numuru (major, minor un patch) nekā pašlaik ierīcē instalētā programmaparatūra. Tas pasargā no downgrade uzbrukumiem, kad droša programmaparatūras versija tiktu aizstāta ar vecu, potenciāli nedrošu versiju.

Piemēri:

• v1.3.1 var atjaunināt uz v1.3.1-test.20230414 un otrādi, jo tiem ir vienāds galvenais, mazākais un labojuma versijas numurs.

• v1.3.1 var atjaunināt uz v1.3.2 vai v1.4.0, jo versijas numurs palielinās.

• v1.3.1 nevar atjaunināt uz v1.3.0-rc.1, jo versijas numurs samazinātos.

Tas galvenokārt attiecas uz lietotājiem, kuri paļaujas uz testēšanas versijās izmantoto funkciju. Stabilās programmaparatūras lietotāji vienmēr var atjaunināt uz jaunāko pieejamo programmaparatūras versiju.

Troubleshooting (Linux):

Problēma: Atjaunināšanas laikā es saņemu permission denied for /dev/hidrawX.

Tas, visticamāk, nozīmē, ka lietotājam nav vajadzīgo atļauju lasīt un rakstīt ierīcē. Pārliecinieties, ka esat iestatījis pareizus udev-rules. Lejupielādējiet šo udev-rules komplektu un ievietojiet to savā udev noteikumu direktorijā (piemēram, /etc/udev/rules.d). Pēc tam izņemiet Nitrokey 3 no USB slota un palaidiet: udevadm control --reload-rules && udevadm trigger vai restartējiet datoru. Pēc tam atjauninājumam vajadzētu darboties bez atļaujas problēmas.