L'API Credential Manager Holder consente alla tua app Android di titolare (chiamata anche "wallet") di gestire e presentare le credenziali digitali ai verificatori.
Formati delle credenziali
Le credenziali possono essere memorizzate nelle app del titolare in diversi formati. Questi formati sono specifiche per la rappresentazione di una credenziale e ognuno contiene le seguenti informazioni sulla credenziale:
- Tipo: la categoria, ad esempio una laurea o una patente di guida.
- Proprietà: attributi come nome e cognome.
Codifica: il modo in cui è strutturata la credenziale, ad esempio SD-JWT o mdoc
Validità: metodo per verificare in modo crittografico l'autenticità della credenziale.
Ogni formato di credenziale esegue la codifica e la convalida in modo leggermente diverso, ma dal punto di vista funzionale sono uguali.
Il registry supporta due formati:
- SD-JWT: conforme alla specifica IETF SD-JWT-based Verifiable Credentials (SD-JWT VC).
- Documenti mobile o mdoc: conformi alla specifica ISO/IEC 18013-5:2021.
Un verificatore può effettuare una richiesta OpenID4VP per SD-JWT e mdoc quando utilizza Gestore delle credenziali. La scelta varia in base al caso d'uso e al settore.
Registrazione dei metadati delle credenziali
Gestore delle credenziali non memorizza direttamente le credenziali di un titolare, ma i metadati delle credenziali. Un'app holder deve prima registrare i metadati delle credenziali
con Gestore delle credenziali utilizzando RegistryManager. Questa procedura di registrazione crea un record del registry che ha due scopi principali:
- Corrispondenza: i metadati delle credenziali registrate vengono utilizzati per la corrispondenza con le richieste future del verificatore.
- Visualizzazione: gli elementi UI personalizzati vengono mostrati all'utente nell'interfaccia del selettore delle credenziali.
Utilizza la classe OpenId4VpRegistry per registrare le tue credenziali digitali,
poiché supporta i formati delle credenziali mdoc e SD-JWT. I verificatori invieranno richieste OpenID4VP per richiedere queste credenziali.
Metodi di emissione delle credenziali
L'emissione delle credenziali può essere attivata in due modi:
- Flusso avviato dall'emittente: l'utente attiva una richiesta di emissione di una VDC da un'applicazione o un sito web dell'emittente. Ad esempio, un sito web può offrire ai suoi utenti l'opzione "Aggiungi il tuo passaporto al tuo wallet". L'emittente chiama l'API di emissione di Gestore delle credenziali per effettuare una richiesta di offerta di credenziali OpenID4VCI. Per gestire queste richieste, un titolare deve prima integrarsi con Gestore delle credenziali per registrare i propri metadati. Gestore delle credenziali mostrerà le opzioni pertinenti che l'utente potrà selezionare. Dopo che l'utente ha selezionato un'opzione di titolare, l'applicazione del titolare verrà richiamata e potrà procedere con i passaggi necessari per completare l'emissione.
- Flusso avviato dal titolare: l'utente richiede di aggiungere una VDC dalla propria applicazione titolare. Ad esempio, un titolare potrebbe offrire un pulsante "Aggiungi il tuo passaporto". In questo caso, il titolare gestisce l'elenco degli emittenti supportati e i metadati. Non è necessario che si integri con Gestore delle credenziali di Android per completare questa funzione.