Problemen oplossen¶
Hier vindt u een verzameling van veel voorkomende problemen.
Nitrokey wordt niet gedetecteerd op Linux¶
Als de Nitrokey niet wordt gedetecteerd, ga dan als volgt te werk:
Kopieer dit bestand 41-nitrokey.rules naar
/etc/udev/rules.d/
.Herstart udev via
sudo service udev restart
ofudevadm control --reload-rules && udevadm trigger
als je Fedora gebruikt.
Nitrokey kaartlezer stuurprogramma kan niet worden geïnstalleerd in Windows¶
Op Windows mislukt de initialisatie van het stuurprogramma voor de generieke smartcardlezer. De gerapporteerde apparaatstatus is This device is not working properly because Windows cannot load the drivers required for this device. (Code 31)
.
Windows heeft twee generieke smartcardlezerdrivers (WUDF en UMDF2). Standaard gebruikt Windows UMDF2, dat niet kan worden geïnitialiseerd en daarom niet wordt geladen voor de Nitrokey.
Om een succesvolle stuurprogramma-initialisatie te garanderen, voeg je een herkansing toe voor de apparaatinitialisatie. Voeg in het register de volgende registersleutel toe.
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography\Calais\Readers
New-ItemProperty -Path 'HKLM:\Software\Microsoft\Cryptography\Calais\Readers' -Name 'RetryDeviceInitialize' -PropertyType 'DWord' -Value 1
Notitie
De registersleutel is beschikbaar voor Windows 10 (versie 1903 (19H1) en later) en Windows 11.
Als de smartcardlezer al eerder was geïnstalleerd met een mislukte initialisatie, moet je deze mogelijk verwijderen uit het register. Verwijder in het register het volgende registerpad.
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography\Calais\Readers\Nitrokey CCID/ICCD Interface 0
Als de smartcardlezer meerdere keren is geïnstalleerd, kan er meer dan één pad zijn met een verhoogd nummer aan het einde.
Get-ChildItem -Path HKLM:\SOFTWARE\Microsoft\Cryptography\Calais\Readers -Include 'Nitrokey CCID/ICCD Interface [0-9]*' -Recurse -Depth 1 | Remove-Item
Na een herstart wordt de Nitrokey herkend als Microsoft Usbccid Smartcard Reader (WUDF).
Google en Microsoft diensten¶
Momenteel lijkt er een bug te zijn die we snel hopen te verhelpen en die de werking van de Nitrokey 3 met sommige Google en Microsoft diensten per FIDO2 beïnvloedt.
Time-out bug¶
Er is een fout met de Nitrokey die door het systeem wordt herkend, waarbij een time-out optreedt voordat de verbinding slaagt.
NFC werkt niet¶
Zorg ervoor dat FIDO2 correct werkt. Anders zal NFC’s ook niet werken.
Also check if you are using the right spot on your smartphone.
De achterkant van de Nitrokey moet tegen de smartphone worden gehouden. Voor de USB-A versie kan het handig zijn om de kant met de USB-aansluiting iets op te tillen om de afstand tot het eindgedeelte van de stick te verkleinen.
Als je een telefoonhoesje hebt, probeer dan eerst de juiste plek te vinden zonder het hoesje. Probeer het daarna opnieuw met het hoesje.
Het zoeken naar de optimale plek duurde soms wel 20-30 sec. Onze ervaring is dat als u de Nitrokey horizontaal houdt, dit betere resultaten oplevert. Als u nog steeds problemen ondervindt, schrijf dan een e-mail naar onze klantenservice. Voor optimale hulp gelieve het verzend/bestelnummer en het model van uw smartphone te vermelden.
OpenPGP problemen oplossen¶
GnuPG: OpenPGP-kaart niet beschikbaar¶
Probleem: GnuPG heeft geen toegang tot de Nitrokey 3 en geeft de volgende foutmelding:
$ gpg --card-status
gpg: selecting openpgp failed: No such device
gpg: OpenPGP card not available: No such device
Oplossing: Er zijn twee veelgebruikte smartcarddiensten op Linux-systemen: scdaemon , de smartcard daemon van GnuPG, en ``pcscd`, een generieke smartcard daemon. scdaemon ` heeft twee stuurprogramma’s voor toegang tot smartcards: Het geïntegreerde ccid
stuurprogramma probeert direct toegang te krijgen tot de smartcard. Het pcsc
stuurprogramma gebruikt in plaats daarvan de pcscd
daemon.
Een smartcard kan maar door één daemon direct benaderd worden. Dit betekent dat, afhankelijk van de opstartvolgorde, pcscd
de kaart kan blokkeren voordat scdaemon
de kaart probeert te benaderen met het interne ccid
stuurprogramma. Daarom raden we aan om het pcscd
stuurprogramma te gebruiken voor scdaemon
. Je kunt deze activeren door disable-ccid
toe te voegen aan het ~/.gnupg/scdaemon.conf
config bestand en scdaemon
opnieuw te starten, bijvoorbeeld met gpg-connect-agent "SCD KILLSCD" /bye
. Als dit het probleem niet verhelpt, zie dan de volgende sectie voor meer informatie.
Je kunt ook pcscd
deactiveren of verwijderen om dit conflict te voorkomen.
pcscd: Kaart niet gevonden¶
Probleem: Een toepassing die pcscd
gebruikt, toont de Nitrokey 3 niet.
Oplossing: Controleer eerst of scdaemon
niet draait (zie de vorige sectie):
$ gpg-connect-agent "SCD KILLSCD" /bye
Maak nu een lijst van de smartcards die worden herkend door pcscd
met pcsc_scan -r
. Je zou een vermelding als deze moeten zien:
$ pcsc_scan -r
Using reader plug'n play mechanism
Scanning present readers..
0: Nitrokey 3 [CCID/ICCD Interface] 00 00
Als de Nitrokey 3 wordt weergegeven, wordt deze correct herkend door pcscd
en is er mogelijk een probleem met de applicatie die toegang probeert te krijgen. Als de Nitrokey niet wordt weergegeven, controleer dan of je libccid
versie up-to-date is. Ondersteuning voor de Nitrokey 3 is toegevoegd in libccid
1.5.0.
De apparaatdatabase bijwerken¶
Als je libccid
niet kunt bijwerken naar een ondersteunde versie, moet je de apparaatdatabase handmatig bijwerken. Het pad van de database hangt af van je distributie:
Arch, Debian, Ubuntu: /etc/libccid_Info.plist
Zorg ervoor dat je een back-up maakt van het bestand voordat je het overschrijft. Je kunt een bijgewerkt apparaatdatabasebestand downloaden van de nitrokey-3-firmware
opslagplaats. Nadat je het bestand hebt bijgewerkt, start je pcscd
opnieuw op en voer je pcsc_scan -r
opnieuw uit. De Nitrokey 3 zou nu moeten verschijnen.
Updaten via update.nitrokey.com werkt niet¶
Momenteel ondersteunt de web updater de Nitrokey 3 niet. U kunt echter de nieuwste firmware krijgen met deze instructies.
PIV Troubleshooting¶
Pyscard is not available¶
Als pyscard niet beschikbaar is voor nitropie, kunt u de volgende foutmelding krijgen wanneer u de PIV-functionaliteit probeert te gebruiken:
Dit commando vereist de pyscard bibliotheek die niet beschikbaar is op uw systeem. Raadpleeg https://docs.nitrokey.com/nitrokeys/nitrokey3/troubleshooting#pyscard-is-not-available voor meer informatie.
Installeer nitropie met de pcsc extra afhankelijkheden om deze fout op te lossen:
pip installeer pynitrokey[pcsc] pipx installeer pynitrokey[pcsc]
Als u pynitrokey installeert via een ander distributiekanaal, installeer dan alle optionele afhankelijkheden voor dit kanaal.