L'emissione di credenziali spiegata: dall'offerta alla credenziale accettata
OpenID4VCI è lo standard europeo per far arrivare una credenziale nel wallet di qualcuno: un diploma, una registrazione d'impresa, un certificato di ispezione. Consegnarne una sembra un momento unico al titolare, ma dietro devono allinearsi diverse cose, e ognuna può fallire a modo suo. Questa pagina le ripercorre, usando come esempio un'impresa di autotrasporto.
Due modi in cui inizia un'emissione
Nella maggior parte dei casi l'emissione inizia con l'emittente che offre una credenziale, di solito come codice QR o link. Se poi il titolare debba fare il login dipende da una cosa sola: l'emittente sa già con chi ha a che fare. Entrambi i percorsi finiscono nello stesso punto, con la credenziale nel wallet.
Il titolare è già conosciuto
1. Issuer
Sa già con chi ha a che fare e offre la credenziale lì per lì
2. Wallet
Accetta l'offerta, a volte confermando un codice breve inviato a parte
3. Wallet
Ritira la credenziale e la lega a questo dispositivo
Il titolare deve prima fare il login
1. Wallet
Parte da un'offerta, oppure va dall'emittente su iniziativa del titolare
2. Login dell'emittente
Guida il titolare attraverso il login e l'accettazione di ciò che verrà emesso
3. Wallet
Ritira la credenziale e la lega a questo dispositivo
L'intero ciclo di vita di un'offerta di credenziale
Un'emissione attraversa i passaggi qui sotto. Ognuno può fallire per conto proprio, e sono quei fallimenti che un servizio di assistenza si trova poi a gestire, quindi vale la pena sapere dove si collocano prima di progettare il processo attorno a essi.
Un esempio concreto: un certificato di idoneità alla circolazione per una flotta di autotrasporto
Un centro di revisione emette un certificato di idoneità alla circolazione nel business wallet di un'impresa di autotrasporto dopo un'ispezione di routine. L'ispettore ha già verificato di persona chi è il responsabile della flotta al punto di controllo, quindi non c'è motivo di fargli fare di nuovo il login.
1. L'offerta
Il terminale al punto di controllo mostra un codice QR
Scansionarlo apre il wallet e mostra quale credenziale viene offerta
2. Che cosa viene offerto
Il wallet legge la descrizione della credenziale pubblicata dall'emittente
Così il responsabile della flotta vede che cosa contiene il certificato prima di accettare qualsiasi cosa
3. Conferma
Il wallet conferma un codice breve che il centro di revisione ha inviato via SMS al responsabile della flotta
Chi fotografa il codice QR alle sue spalle non può comunque ritirare il certificato
4. Legarla al wallet
Il wallet dimostra di possedere un segreto che non lascia mai il dispositivo
Il certificato è legato a quel segreto, quindi una sua copia non vale nulla su un altro dispositivo
5. Emesso e salvato
Il centro di revisione firma il certificato e il wallet lo salva
Da qui l'impresa di autotrasporto può mostrarlo a un cliente o a un agente di controllo in pochi secondi
Quando la credenziale non è ancora pronta
L'esempio qui sopra presuppone che l'esito dell'ispezione sia definitivo. Se un esito borderline deve prima passare da un ispettore senior, il certificato non può essere consegnato sul posto. Lo standard prevede questo caso invece di costringere il responsabile della flotta a tornare.
Emessa sul posto
Il titolare se ne va con la credenziale nel proprio wallet, in un'unica volta.
Emessa in seguito
L'emittente comunica che gli serve più tempo e il wallet ritira la credenziale quando è pronta. Il titolare non deve ricominciare da capo né tornare di persona.
Chiudere il cerchio
Dopo l'emissione il wallet può comunicare all'emittente come si è conclusa. È facoltativo per entrambe le parti e la consegna non è garantita, quindi è utile per individuare un flusso interrotto, ma un emittente non può trarre conclusioni da un messaggio che non arriva mai.
Wallet
Può comunicare all'emittente come si è conclusa l'emissione
Salvata
La credenziale è nel wallet e pronta all'uso
Non riuscita
Qualcosa è andato storto, per esempio la credenziale non ha superato la verifica
Rifiutata
Il titolare ha scelto di non conservarla
Che cosa significa per te
Issuer
Un unico modo standard di consegnare credenziali che ogni wallet conforme accetta, senza integrazioni per singolo wallet e senza un portale in cui i titolari debbano fare il login.
Titolare
Vedi che cosa ti viene dato prima di accettarlo, ed è legato al tuo dispositivo e non a un login che potresti perdere.
Verificatore
Le credenziali arrivano già verificate e già legate al wallet che le presenta, quindi accettarne una è un controllo e non un'indagine.
Approfondimento tecnico
Questa pagina spiega che cosa fa la tecnologia e chi riguarda. La nostra documentazione per sviluppatori copre l'implementazione vera e propria: i messaggi, i campi e gli esempi concreti di cui ha bisogno un team di integrazione.
Leggi la documentazione tecnicaTermini correlati
Domande frequenti
Quando il titolare deve fare il login e quando no?
Dipende dal fatto che l'emittente sappia già con chi ha a che fare. Un ispettore che ha appena controllato di persona un veicolo non ha bisogno che il responsabile della flotta faccia di nuovo il login, quindi la credenziale viene offerta sul posto. Un servizio online che non ha mai incontrato il titolare lo fa passare prima dal proprio login. È l'offerta stessa a indicare quale dei due casi si applica.
Come fa il wallet a sapere che cosa sta per ricevere?
Ogni emittente pubblica una descrizione di ciò che emette, e il wallet la legge prima di qualsiasi altra cosa. È quello che permette al wallet di mostrare al titolare che cos'è la credenziale e che cosa contiene, così il consenso ha un senso. Significa anche che un emittente può aggiungere un nuovo tipo di credenziale senza che ogni wallet debba essere aggiornato.
Che cosa impedisce di copiare una credenziale su un altro dispositivo?
Prima dell'emissione il wallet dimostra di possedere un segreto che non lascia mai il dispositivo, e l'emittente lega la credenziale a quel segreto. Più avanti un verificatore può chiedere al wallet di dimostrare di nuovo la stessa cosa. Una copia della credenziale senza quel segreto non supera il controllo, quindi copiare il file non serve a nulla.
E se la credenziale non può essere emessa subito?
Alcuni controlli richiedono più tempo di quanto una persona sia disposta ad aspettare: una revisione manuale o un'interrogazione a un registro esterno lento. L'emittente può dichiararlo e il wallet ritira la credenziale quando è pronta. Il titolare non deve ricominciare da capo né tornare di persona.
L'emittente scopre se la credenziale è stata davvero conservata?
Può farlo, ma solo per cortesia. Il wallet può segnalare che la credenziale è stata salvata, che il titolare l'ha rifiutata o che qualcosa non ha funzionato. Nessuna delle due parti è obbligata a supportarlo e la consegna non è garantita, quindi un emittente dovrebbe trattarlo come un segnale utile e mai come una registrazione di quanto accaduto.
Fonti
Questa pagina ha scopo informativo e non costituisce consulenza legale. Per indicazioni autorevoli rivolgersi direttamente alla OpenID Foundation e alla Commissione europea.