Trikčių šalinimas¶
Čia rasite dažniausiai pasitaikančių problemų rinkinį.
„Nitrokey“ neaptinkamas „Linux¶
Jei „Nitrokey“ neaptinkamas, elkitės taip:
Copy this file 41-nitrokey.rules to
/etc/udev/rules.d/.Iš naujo paleiskite udev per
sudo service udev restartarbaudevadm control --reload-rules && udevadm trigger, jei naudojate „Fedora“.
„Nitrokey“ kortelių skaitytuvo tvarkyklės negalima įdiegti „Windows¶
„Windows“ sistemoje nepavyksta inicializuoti bendrosios lustinių kortelių skaitytuvo tvarkyklės. Pranešama tokia įrenginio būsena: This device is not working properly because Windows cannot load the drivers required for this device. (Code 31).
Ši problema egzistuoja „Windows 10“ ir „Windows Server 2022“ bei senesnėse sistemose. Nuo „Windows 11“ ir „Windows Server 2025“ elgiamasi teisingai ir toliau pateikiamas sprendimas nereikalingas.
„Windows“ turi dvi bendrąsias išmaniųjų kortelių skaitytuvų tvarkykles (WUDF ir UMDF2). Pagal numatytuosius nustatymus „Windows“ naudoja UMDF2, kurios nepavyksta inicializuoti, todėl ji neįkeliama į „Nitrokey“.
Norėdami užtikrinti sėkmingą tvarkyklės inicializavimą, pridėkite pakartotinį įrenginio inicializavimo bandymą. Registre pridėkite šį registro raktą.
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography\Calais\ReadersDWORD (32-bit)1New-ItemProperty -Path 'HKLM:\Software\Microsoft\Cryptography\Calais\Readers' -Name 'RetryDeviceInitialize' -PropertyType 'DWord' -Value 1
Pastaba
Registro raktą galima naudoti „Windows 10“ (1903 (19H1) ir vėlesnėse versijose) ir „Windows 11“.
Jei išmaniųjų kortelių skaitytuvas prieš tai jau buvo įdiegtas ir nepavyko jo inicializuoti, gali tekti jį pašalinti iš registro. Registre ištrinkite šį registro kelią.
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography\Calais\Readers\Nitrokey CCID/ICCD Interface 0Jei išmaniųjų kortelių skaitytuvas anksčiau buvo įdiegtas kelis kartus, gali būti daugiau nei vienas kelias su padidintu numeriu pabaigoje.
Get-ChildItem -Path HKLM:\SOFTWARE\Microsoft\Cryptography\Calais\Readers -Include 'Nitrokey CCID/ICCD Interface [0-9]*' -Recurse -Depth 1 | Remove-Item
Po perkrovimo „Nitrokey“ atpažįstamas kaip „Microsoft Usbccid Smartcard Reader“ (WUDF).
„Nitrokey 3“ sistemoje „Windows“ atpažįstama kaip „Nežinoma lustinė kortelė¶
Sistemoje „Windows Server 2025“ nepavyksta inicializuoti bendrosios išmaniosios kortelės tvarkyklės. Įrenginys atpažįstamas kaip „Nežinoma lustinė kortelė“ ir jokia tvarkyklė neįdiegiama.
Norėdami įdiegti tinkamą išmaniosios kortelės tvarkyklę, ją įdiekite taip.
Atidarykite „Windows“ Device Manager (
devmgmt.msc).Atverkite grupę Išmaniosios kortelės prietaisų medyje. Jei grupė neegzistuoja, įsitikinkite, kad „Nitrokey“ tinkamai prijungtas.
Dešiniuoju pelės klavišu spustelėkite Nežinoma išmanioji kortelė ir pasirinkite Atnaujinti tvarkyklę.
Vairuotojo naujinimo asistento programoje pirmiausia pasirinkite Ieškoti tvarkyklių mano kompiuteryje, tada Leiskite man pasirinkti iš mano kompiuteryje esančių tvarkyklių sąrašo. Deaktyvuokite žymimąjį langelį Show compatible hardware (rodyti suderinamą techninę įrangą) ir sąraše pasirinkite Identity Device (NIST SP 800-73 [PIV]). Patvirtinkite pasirinkimą spustelėdami Next mygtuką ir patvirtinkite įspėjimo apie tvarkyklę dialogo langą Yes. Įdiegę tvarkyklę, uždarykite tvarkyklės naujinimo pagalbininką spustelėdami mygtuką Uždaryti.
Dabar „Nitrokey“ pripažįstama išmaniųjų kortelių grupėje kaip tapatybės įrenginys (NIST SP 800-73 [PIV]).
Prijungus „Nitrokey“ prie kito USB prievado, šį procesą gali tekti pakartoti.
„Google“ ir „Microsoft“ paslaugos¶
Šiuo metu, atrodo, yra klaida, kurią tikimės netrukus ištaisyti ir kuri turi įtakos „Nitrokey 3“ veikimui su kai kuriomis „Google“ ir „Microsoft“ paslaugomis pagal FIDO2.
Laiko limito klaida¶
Sistema atpažįsta „Nitrokey“ raktą, todėl prieš sėkmingą prisijungimą atsiranda laiko tarpas.
NFC neveikia¶
Įsitikinkite, kad FIDO2 veikia tinkamai. Priešingu atveju neveiks ir NFC.
Also check if you are using the right spot on your smartphone.
„Nitrokey“ nugarėlė turi būti priglausta prie išmaniojo telefono. USB-A versijos atveju gali būti naudinga šiek tiek pakelti pusę su USB jungtimi, kad būtų sumažintas atstumas iki lazdos galinės dalies.
Jei turite telefono dangtelį, pirmiausia pabandykite rasti tinkamą vietą be jo. Vėliau bandykite su dangteliu.
Optimalios vietos paieška kartais užtrukdavo iki 20-30 sek. Mūsų patirtis rodo, kad laikant „Nitrokey“ horizontalioje padėtyje rezultatai yra geresni.Jei vis dar susiduriate su problemomis, parašykite laišką mūsų palaikymo tarnybai. Kad pagalba būtų optimali, nurodykite siuntimo / užsakymo numerį ir savo išmaniojo telefono modelį.
„OpenPGP“ trikčių šalinimas¶
GnuPG: OpenPGP kortelė nepasiekiama¶
Problema: GnuPG negali pasiekti „Nitrokey 3“ ir rodo tokį klaidos pranešimą:
$ gpg --card-status
gpg: selecting openpgp failed: No such device
gpg: OpenPGP card not available: No such device
Sprendimas: Linux sistemose yra dvi įprastos išmaniųjų kortelių paslaugos: scdaemon ` , GnuPG išmaniųjų kortelių demonas, ir ``pcscd`, bendrasis išmaniųjų kortelių demonas. scdaemon turi dvi tvarkykles, skirtas prieigai prie išmaniųjų kortelių: Integruota ccid tvarkyklė bando tiesiogiai pasiekti išmaniąją kortelę. Vietoj to pcsc tvarkyklės naudoja pcscd demoną.
Tiesioginę prieigą prie išmaniosios kortelės gali turėti tik vienas demonas. Tai reiškia, kad, priklausomai nuo paleidimo eiliškumo, pcscd gali užrakinti kortelę prieš scdaemon bandant ją pasiekti naudojant vidinę ccid tvarkyklę. Todėl rekomenduojame naudoti pcscd tvarkyklę scdaemon. Ją galite aktyvuoti į ~/.gnupg/scdaemon.conf konfigūracijos failą įtraukdami disable-ccid ir iš naujo paleisdami scdaemon, pavyzdžiui, su gpg-connect-agent "SCD KILLSCD" /bye. Jei tai problemos neišsprendžia, daugiau informacijos rasite kitame skyriuje.
Kad išvengtumėte šio konflikto, galite išjungti arba pašalinti pcscd.
pcscd: Kortelė nerasta¶
Problema: Programoje, kurioje naudojama pcscd, nerodomas „Nitrokey 3“ klavišas.
Sprendimas: Pirmiausia įsitikinkite, kad scdaemon nėra paleistas (žr. ankstesnį skyrių):
$ gpg-connect-agent "SCD KILLSCD" /bye
Dabar išvardykite išmaniąsias korteles, kurias atpažįsta pcscd su pcsc_scan -r. Turėtumėte pamatyti tokį įrašą kaip šis:
$ pcsc_scan -r
Using reader plug'n play mechanism
Scanning present readers..
0: Nitrokey 3 [CCID/ICCD Interface] 00 00
Jei „Nitrokey 3“ rodomas, vadinasi, pcscd jį atpažįsta teisingai ir gali būti, kad programa, kuri bando jį pasiekti, susidūrė su problema. Jei jis nerodomas, įsitikinkite, kad jūsų libccid versija yra atnaujinta. Į libccid 1.5.0 ` versiją įtrauktas „Nitrokey 3“ palaikymas.
Įrenginio duomenų bazės atnaujinimas¶
Jei negalite atnaujinti libccid į palaikomą versiją, turite rankiniu būdu atnaujinti įrenginio duomenų bazę. Duomenų bazės kelias priklauso nuo jūsų distribucijos:
Arch, Debian, Ubuntu:
/etc/libccid_Info.plist
Prieš perrašydami failą būtinai sukurkite atsarginę jo kopiją. Iš nitrokey-3-firmware saugyklos galite atsisiųsti atnaujintą prietaisų duomenų bazės failą. Atnaujinę failą, iš naujo paleiskite pcscd ir vėl paleiskite pcsc_scan -r. Dabar turėtų pasirodyti „Nitrokey 3“.
Atnaujinimas per update.nitrokey.com neveikia¶
Šiuo metu žiniatinklio atnaujinimo programa nepalaiko „Nitrokey 3“. Tačiau naujausią programinę įrangą galite gauti naudodamiesi šiomis instrukcijomis.
PIV Troubleshooting¶
Pyscard is not available¶
If pyscard is not available to nitropy, you might get the following error when trying to use the PIV functionality:
This command requires the pyscard library that is not available on your system. Please consult https://docs.nitrokey.com/nitrokeys/nitrokey3/troubleshooting#pyscard-is-not-available for more information
To fix this error, please install nitropy with the pcsc extra dependencies:
pip install pynitrokey[pcsc]
pipx install pynitrokey[pcsc]
Jei įdiegsite pynitrokey per kitą paskirstymo kanalą, įdiekite visas neprivalomas šio kanalo priklausomybes.