Risoluzione dei problemi

Qui troverete una raccolta di problemi comuni.

Nitrokey non viene rilevato su Linux

Se la Nitrokey non viene rilevata, procedete come segue:

  1. Copy this file 41-nitrokey.rules to /etc/udev/rules.d/.

  2. Riavviare udev tramite sudo service udev restart o udevadm control --reload-rules && udevadm trigger se si utilizza Fedora.

Il driver del lettore di schede Nitrokey non può essere installato su Windows

In Windows l’inizializzazione del driver generico del lettore di smartcard non riesce. Lo stato del dispositivo riportato è This device is not working properly because Windows cannot load the drivers required for this device. (Code 31).

Questo problema esiste su Windows 10 e Windows Server 2022 e precedenti. A partire da Windows 11 e Windows Server 2025 il comportamento è corretto e la soluzione riportata di seguito non è necessaria.

Windows dispone di due driver generici per i lettori di smartcard (WUDF e UMDF2). Per impostazione predefinita Windows utilizza UMDF2, che non riesce a inizializzarsi e quindi non viene caricato per Nitrokey.

<x id=»0»></x><x id=»2»></x><x id=»13»></x>

Path: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography\Calais\Readers
Percorso: <x id=»6»></x>`<x id=»8»></x><x id=»73»></x>`
Tipo: DWORD (32-bit)
Dati: 1

Nota

La chiave di registro è disponibile per Windows 10 (versione 1903 (19H1) e successive) e per Windows 11.

Se il lettore di smartcard era già stato installato in precedenza con un’inizializzazione fallita, potrebbe essere necessario rimuoverlo dal registro di sistema. Nel registro di sistema eliminare il seguente percorso di registro.

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

Se il lettore di smartcard è stato installato più volte in precedenza, potrebbe esserci più di un percorso con un numero incrementato alla fine.

Dopo un riavvio, Nitrokey viene riconosciuto come Microsoft Usbccid Smartcard Reader (WUDF).

Nitrokey 3 viene riconosciuto come «Smart Card sconosciuta» su Windows

Su Windows Server 2025, l’inizializzazione del driver generico della smart card non riesce. Il dispositivo viene riconosciuto come «Smart Card sconosciuta» e non viene installato alcun driver.

Per installare il driver della smart card corretto, installare il driver corretto come segue.

  1. Aprire la Gestione periferiche di Windows ** (devmgmt.msc).

  2. Aprire il gruppo Smart card dalla struttura dei dispositivi. Se il gruppo non esiste, verificare che Nitrokey sia collegato correttamente.

  3. Fare clic con il tasto destro del mouse su Smart Card sconosciuta e selezionare Aggiorna driver.

  4. Nell’assistente all’aggiornamento dei driver, selezionare prima Sfoglia il mio computer per i driver e poi Fammi scegliere da un elenco di driver disponibili sul mio computer. Disattivate la casella di controllo Mostra hardware compatibile e selezionate Dispositivo di identità (NIST SP 800-73 [PIV]) dall’elenco. Confermare la selezione facendo clic sul pulsante Next e confermare la finestra di dialogo di avviso del driver con Yes. Una volta installato il driver, chiudere l’assistente all’aggiornamento del driver facendo clic sul pulsante Close.

  5. Nitrokey è ora riconosciuto nel gruppo Smart card come Dispositivo di identità (NIST SP 800-73 [PIV]).

Il collegamento di Nitrokey a una porta USB diversa può richiedere la ripetizione di questo processo.

Servizi Google e Microsoft

Attualmente sembra esserci un bug che speriamo di risolvere presto e che riguarda il funzionamento di Nitrokey 3 con alcuni servizi Google e Microsoft per FIDO2.

Bug del timeout

C’è un bug nel riconoscimento della Nitrokey da parte del sistema, dove si verifica un timeout prima che la connessione riesca.

L’NFC non funziona

Assicurati che FIDO2 funzioni correttamente. Altrimenti anche l’NFC non funzionerà.

Also check if you are using the right spot on your smartphone.

La parte posteriore della Nitrokey deve essere tenuta contro lo smartphone. Per la versione USB-A potrebbe essere utile sollevare leggermente il lato con il connettore USB per ridurre la distanza dalla parte finale della chiavetta.

Se hai una cover per il telefono, prova a trovare prima il punto giusto senza di essa. Riprova dopo con la cover.

La ricerca del punto ottimale richiedeva a volte fino a 20-30 secondi. Secondo la nostra esperienza, tenendo la Nitrokey in posizione orizzontale si ottengono risultati migliori. Se hai ancora problemi, scrivi una mail al nostro supporto. Per un aiuto ottimale ti preghiamo di includere il numero di spedizione/ordine e il modello del tuo smartphone.

Risoluzione dei problemi di OpenPGP

GnuPG: scheda OpenPGP non disponibile

Problema: GnuPG non riesce ad accedere a Nitrokey 3 e mostra un messaggio di errore come questo:

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

Soluzione: Esistono due servizi di smartcard comuni sui sistemi Linux: scdaemon, il demone smartcard di GnuPG, e pcscd, un demone smartcard generico. scdaemon ` ha due driver per accedere alle smartcard: Il driver integrato ccid cerca di accedere direttamente alla smartcard. Il driver pcsc utilizza invece il demone pcscd.

Una smartcard può essere accessibile direttamente solo da un demone. Ciò significa che, a seconda dell’ordine di avvio, pcscd potrebbe bloccare la scheda prima che scdaemon tenti di accedervi usando il driver interno ccid. Pertanto si consiglia di utilizzare il driver pcscd per scdaemon. È possibile attivarlo aggiungendo disable-ccid al file di configurazione ~/.gnupg/scdaemon.conf e riavviando scdaemon, ad esempio con gpg-connect-agent "SCD KILLSCD" /bye. Se questo non risolve il problema, si veda la sezione successiva per ulteriori informazioni.

In alternativa, è possibile disattivare o disinstallare pcscd per evitare questo conflitto.

pcscd: Scheda non trovata

Problema: Un’applicazione che utilizza pcscd non mostra la Nitrokey 3.

Soluzione: Per prima cosa, assicurarsi che scdaemon non sia in esecuzione (vedere la sezione precedente):

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

Ora elencare le smartcard riconosciute da pcscd con pcsc_scan -r. Si dovrebbe vedere una voce come questa:

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

Se Nitrokey 3 viene visualizzato, è riconosciuto correttamente da pcscd e potrebbe esserci un problema con l’applicazione che cerca di accedervi. Se non viene visualizzata, assicurarsi che la versione di libccid sia aggiornata. Il supporto per Nitrokey 3 è stato aggiunto nella versione libccid 1.5.0.

Aggiornamento del database dei dispositivi

Se non è possibile aggiornare libccid a una versione supportata, è necessario aggiornare manualmente il database dei dispositivi. Il percorso del database dipende dalla distribuzione:

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

Assicurarsi di eseguire un backup del file prima di sovrascriverlo. È possibile scaricare un file aggiornato del database dei dispositivi dal repository nitrokey-3-firmware. Dopo aver aggiornato il file, riavviare pcscd ed eseguire nuovamente pcsc_scan -r. Nitrokey 3 dovrebbe ora apparire.

L’aggiornamento tramite update.nitrokey.com non funziona

Al momento il programma di aggiornamento web non supporta il Nitrokey 3. Tuttavia, è possibile ottenere il firmware più recente utilizzando le istruzioni di firmware-update.html .

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]

Se si installa pynitrokey attraverso un altro canale di distribuzione, installare tutte le dipendenze opzionali per questo canale.