Rozwiązywanie problemów#

Tutaj znajdziesz zbiór najczęściej występujących problemów.

Nitrokey nie jest wykrywany w systemie Linux#

Jeśli Nitrokey nie zostanie wykryty, wykonaj następujące czynności:

  1. Skopiuj ten plik 41-nitrokey.rules do /etc/udev/rules.d/.

  2. Uruchom ponownie udev przez sudo service udev restart lub udevadm control --reload-rules && udevadm trigger jeśli używasz Fedory.

Nie można zainstalować sterownika czytnika kart Nitrokey w systemie Windows#

W systemie Windows inicjalizacja ogólnego sterownika czytnika kart inteligentnych nie powiodła się. Zgłoszony status urządzenia to This device is not working properly because Windows cannot load the drivers required for this device. (Code 31).

System Windows ma dwa ogólne sterowniki czytników kart inteligentnych (WUDF i UMDF2). Domyślnie Windows używa UMDF2, który nie inicjalizuje się i dlatego nie jest ładowany dla Nitrokey.

Aby zapewnić pomyślną inicjalizację sterownika, dodaj ponowną próbę inicjalizacji urządzenia. W rejestrze należy dodać następujący klucz rejestru.

Path: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography\Calais\Readers
Ścieżka: <x id=”6”></x>`<x id=”8”></x><x id=”73”></x>`
Wpisz: DWORD (32-bit)
Dane: 1

Informacja

Klucz rejestru jest dostępny dla systemów Windows 10 (wersja 1903 (19H1) i nowsze) oraz Windows 11.

Jeśli czytnik kart inteligentnych był już wcześniej zainstalowany z nieudaną inicjalizacją, może być konieczne usunięcie go z rejestru. W rejestrze należy usunąć następującą ścieżkę rejestru.

Path: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography\Calais\Readers\Nitrokey CCID/ICCD Interface 0

Jeśli czytnik kart inteligentnych był wcześniej wielokrotnie instalowany, może istnieć więcej niż jedna ścieżka z rosnącym numerem na końcu.

Po ponownym uruchomieniu Nitrokey jest rozpoznawany jako Microsoft Usbccid Smartcard Reader (WUDF).

Usługi Google i Microsoft#

Obecnie wydaje się, że istnieje błąd, który mamy nadzieję wkrótce naprawić, który wpływa na działanie Nitrokey 3 z niektórymi usługami Google i Microsoft na FIDO2.

Błąd limitu czasu#

Występuje błąd związany z rozpoznawaniem Nitrokey przez system, w wyniku którego następuje przekroczenie limitu czasu, zanim połączenie zostanie nawiązane.

NFC nie działa#

Proszę upewnić się, że FIDO2 działa poprawnie. W przeciwnym razie NFC również nie będzie działać.

Sprawdź również, czy używasz właściwego miejsca na smartfonie.

Tylna strona Nitrokey musi być przytrzymywana przy smartfonie. W przypadku wersji z USB-A pomocne może być lekkie uniesienie strony ze złączem USB, aby zmniejszyć odległość końcowej części drążka.

Jeśli masz pokrowiec na telefon, spróbuj najpierw znaleźć właściwe miejsce bez niego. Potem spróbuj ponownie z pokrowcem.

Poszukiwanie optymalnego miejsca trwało czasami do 20-30 sekund. Z naszego doświadczenia wynika, że trzymanie Nitrokey w orientacji poziomej daje lepsze rezultaty.Jeśli nadal napotykasz problemy, napisz maila do naszego supportu. W celu uzyskania optymalnej pomocy prosimy o podanie numeru przesyłki/zamówienia oraz modelu smartfona.

Rozwiązywanie problemów z OpenPGP#

GnuPG: karta OpenPGP niedostępna#

Problem: GnuPG nie może uzyskać dostępu do Nitrokey 3 i wyświetla następujący komunikat o błędzie:

$ gpg --card-status
gpg: selecting openpgp failed: No such device
gpg: OpenPGP card not available: No such device

Rozwiązanie: Istnieją dwie popularne usługi kart inteligentnych w systemach Linux: scdaemon, demon kart inteligentnych GnuPG, oraz pcscd, ogólny demon kart inteligentnych. scdaemon ` posiada dwa sterowniki dostępu do kart inteligentnych: Zintegrowany sterownik ccid próbuje uzyskać bezpośredni dostęp do karty. Sterowniki pcsc używają zamiast tego demona pcscd.

Karta inteligentna może być dostępna bezpośrednio tylko przez jednego demona. Oznacza to, że w zależności od kolejności uruchamiania, pcscd może zablokować kartę, zanim scdaemon spróbuje uzyskać do niej dostęp za pomocą wewnętrznego sterownika ccid. Dlatego zalecamy użycie sterownika pcscd dla scdaemon. Można go aktywować poprzez dodanie disable-ccid do pliku konfiguracyjnego ~/.gnupg/scdaemon.conf i ponowne uruchomienie scdaemon, na przykład za pomocą gpg-connect-agent "SCD KILLSCD" /bye. Jeśli to nie rozwiąże problemu, zobacz następną sekcję, aby uzyskać więcej informacji.

Alternatywnie można dezaktywować lub odinstalować pcscd, aby uniknąć tego konfliktu.

pcscd: Nie znaleziono karty#

Problem: Aplikacja używająca pcscd nie pokazuje Nitrokey 3.

Rozwiązanie: Najpierw upewnij się, że scdaemon nie jest uruchomiony (patrz poprzednia sekcja):

$ gpg-connect-agent "SCD KILLSCD" /bye

Teraz wyświetl listę kart rozpoznanych przez pcscd z pcsc_scan -r. Powinieneś zobaczyć wpis taki jak ten:

$ pcsc_scan -r
Using reader plug'n play mechanism
Scanning present readers..
0: Nitrokey 3 [CCID/ICCD Interface] 00 00

Jeśli Nitrokey 3 pojawia się, jest poprawnie rozpoznawany przez pcscd i może być problem z aplikacją, która próbuje uzyskać do niego dostęp. Jeśli się nie pojawi, upewnij się, że wersja libccid jest aktualna. Wsparcie dla Nitrokey 3 zostało dodane w libccid 1.5.0.

Aktualizacja bazy danych urządzeń#

Jeśli nie można zaktualizować libccid do obsługiwanej wersji, należy ręcznie zaktualizować bazę danych urządzeń. Ścieżka do bazy danych zależy od dystrybucji:

  • Arch, Debian, Ubuntu: /etc/libccid_Info.plist

Przed nadpisaniem pliku należy wykonać jego kopię zapasową. Możesz pobrać zaktualizowany plik bazy danych urządzeń ` <https://github.com/Nitrokey/nitrokey-3-firmware/blob/main/Info.plist>` __ z repozytorium nitrokey-3-firmware. Po zaktualizowaniu pliku, uruchom ponownie pcscd i uruchom ponownie pcsc_scan -r. Nitrokey 3 powinien się teraz pojawić.

Aktualizacja przez stronę update.nitrokey.com nie działa#

Obecnie aktualizator internetowy nie obsługuje Nitrokey 3. Możesz jednak uzyskać najnowszy firmware używając tych instrukcji ` <firmware-update.html>`_ .

Rozwiązywanie problemów z PIV#

Karta Pyscard nie jest dostępna#

Jeśli pyscard nie jest dostępna dla nitropii, może pojawić się następujący błąd podczas próby użycia funkcji PIV:

To polecenie wymaga biblioteki pyscard, która nie jest dostępna w systemie. Więcej informacji można znaleźć na stronie https://docs.nitrokey.com/nitrokeys/nitrokey3/troubleshooting#pyscard-is-not-available.

Aby naprawić ten błąd, należy zainstalować nitropię z dodatkowymi zależnościami pcsc:

pip install pynitrokey[pcsc] pipx install pynitrokey[pcsc]

Jeśli instalujesz pynitrokey za pośrednictwem innego kanału dystrybucji, zainstaluj wszystkie opcjonalne zależności dla tego kanału.