L'API Credential Manager Holder permet à votre application de titulaire Android (également appelée "portefeuille") de gérer et de présenter des identifiants numériques aux outils de validation.
Formats d'identifiants
Les identifiants peuvent être stockés dans des applications de portefeuille dans différents formats. Ces formats sont des spécifications de la manière dont un identifiant doit être représenté, et chacun contient les informations suivantes sur l'identifiant :
- Type : catégorie, par exemple un diplôme universitaire ou un permis de conduire.
- Propriétés : attributs tels que le prénom et le nom.
Encodage : structure de l'identifiant, par exemple SD-JWT ou mdoc
Validité : méthode permettant de vérifier l'authenticité de l'identifiant de manière cryptographique.
Chaque format d'identifiant effectue l'encodage et la validation de manière légèrement différente, mais ils sont fonctionnellement identiques.
Le registre accepte deux formats :
- SD-JWT : conforme à la spécification des identifiants vérifiables basés sur SD-JWT (SD-JWT VC) de l'IETF.
- Documents mobiles ou mdocs : conformes à la spécification ISO/CEI 18013-5:2021.
Un vérificateur peut envoyer une requête OpenID4VP pour SD-JWT et mdocs lorsqu'il utilise Credential Manager. Le choix varie en fonction du cas d'utilisation et du secteur d'activité.
Enregistrement des métadonnées d'identifiants
Le Gestionnaire d'identifiants ne stocke pas directement les identifiants d'un titulaire, mais plutôt les métadonnées des identifiants. Une application de stockage doit d'abord enregistrer les métadonnées des identifiants auprès de Credential Manager à l'aide de RegistryManager. Ce processus d'enregistrement crée un enregistrement de registre qui remplit deux objectifs clés :
- Correspondance : les métadonnées des identifiants enregistrés sont utilisées pour correspondre aux futures requêtes de vérification.
- Affichage : les éléments d'interface utilisateur personnalisés sont présentés à l'utilisateur sur l'interface du sélecteur d'identifiants.
Utilisez la classe OpenId4VpRegistry pour enregistrer vos identifiants numériques, car elle est compatible avec les formats d'identifiants mdoc et SD-JWT. Les vérificateurs envoient des requêtes OpenID4VP pour demander ces identifiants.
Méthodes d'émission d'identifiants
L'émission d'identifiants peut être déclenchée de deux manières :
- Flux initié par l'émetteur : l'utilisateur déclenche une demande d'émission d'une carte de débit virtuelle à partir d'une application ou d'un site Web de l'émetteur. Par exemple, un site Web peut proposer à ses utilisateurs d'ajouter leur passeport à leur portefeuille. L'émetteur appelle l'API d'émission de Credential Manager pour envoyer une requête d'offre d'identifiant OpenID4VCI. Pour traiter ces requêtes, un titulaire doit d'abord s'intégrer à Credential Manager pour enregistrer ses métadonnées. Credential Manager affiche les options pertinentes parmi lesquelles l'utilisateur peut choisir. Une fois que l'utilisateur a sélectionné une option de titulaire, l'application du titulaire est appelée et peut procéder aux étapes nécessaires pour finaliser l'émission.
- Flux initié par le titulaire : l'utilisateur demande à ajouter une carte de vaccination numérique depuis son application de titulaire. Par exemple, un titulaire peut proposer un bouton "Ajouter votre passeport". Dans ce cas, le titulaire gère sa liste d'émetteurs compatibles et ses métadonnées. Il n'a pas besoin de s'intégrer au Gestionnaire d'identifiants Android pour remplir cette fonction.