Une pièce d'identité de test vous permet d'exécuter l'intégralité du flux de présentation et de vérifier que votre service accepte et valide une réponse Google Wallet, sans avoir besoin d'une vraie pièce d'identité officielle. Vous créez la pièce d'identité de test en scannant un passeport électronique simulé dans Google Wallet sur votre appareil de bac à sable.
Choisissez votre mode de jeu RP, RV ou en personne
Étapes sur cette page
Étape A : Configurez vos deux appareils Android
Vous avez besoin de deux appareils Android : le premier simule un passeport électronique, et le second est celui sur lequel vous ajoutez le pass d'identité dérivé du passeport électronique simulé.
| Exigence | Appareil 1 : simulateur de passeport | Appareil 2 : votre Google Wallet de test |
|---|---|---|
| Rôle | Simule un passeport électronique NFC | Contient le pass d'identité de test dans Google Wallet |
| Procédure de configuration |
|
|
Étape B : Ajouter la pièce d'identité de test à Wallet
- Sur l'Appareil 2, ouvrez l'application Google Wallet et appuyez sur Ajouter à Wallet.
- Sélectionnez Pièce d'identité > Pass d'identité.
- Suivez les instructions à l'écran jusqu'à la fin :
- Analyse de la MRZ : sur l'Appareil 1, appuyez sur l'entrée que vous avez créée précédemment dans l'application de simulation, puis saisissez manuellement les informations du passeport sur l'Appareil 2.
- Lecture NFC : placez l'appareil 1 (avec la page MRZ de l'application de simulation ouverte) contre l'arrière de l'appareil 2 pendant la lecture NFC.
Étape C : Afficher les détails dans Wallet
- Une fois votre pass d'identité dans Google Wallet, appuyez sur le menu à trois points en haut à droite, puis sélectionnez Infos sur le pass d'identité.
- Appuyez sur les options listées et vérifiez qu'elles fonctionnent comme prévu. En particulier, ouvrez la section des détails de la carte pour confirmer que les attributs correspondent à l'entrée que vous avez créée.
Étape D : Utilisez votre ID de test dans les requêtes
Votre pièce d'identité de test de bac à sable est un pass d'identité. Pour que Google Wallet puisse la faire correspondre et la présenter, votre dcql_query OpenID4VP doit demander un type de document de pass d'identité :
com.google.wallet.idcard.1(pass d'identité) ouorg.iso.23220.photoid.1(pass d'identité utilisant le type de document "pièce d'identité avec photo ISO")
Une requête qui demande uniquement un permis de conduire mobile (org.iso.18013.5.1.mDL) ne correspondra pas au pass d'identité de test Utopia. Pour accepter n'importe quel identifiant éligible, utilisez l'exemple multi-identifiant dcql_query à l'étape 3.A : Formater la requête, et consultez Identifiants et attributs acceptés pour connaître les chemins d'accès aux revendications disponibles.
Testez votre nouveau pass d'identité en deux étapes :
- Vérification rapide avec l'outil Web Verifier : ouvrez verifier.multipaz.org sur l'Appareil 2 (ou sur un navigateur pour ordinateur pour tester le QR code sur plusieurs appareils) et demandez un pass d'identité. Cela permet de confirmer que votre appareil et votre pass d'identité de test fonctionnent avant de tester votre propre code.
- Effectuer des tests sur votre propre service : une fois l'étape 3 terminée, envoyez une requête signée avec les clés de test du bac à sable (parties de confiance) ou votre CA racine du bac à sable (registres de vérificateurs), puis configurez votre serveur pour valider
issuerAuthpar rapport au certificat du bac à sable Utopia.
Dépannage
| Problème | Points à vérifier |
|---|---|
| TapAndPay Environment est manquant dans les paramètres | Votre compte Google ne figure pas encore sur la liste d'autorisation du bac à sable. Consultez l'étape 1.A : Demander l'accès au bac à sable. |
| L'option Pass d'identité ne s'affiche pas sous Ajouter à Wallet. | Vérifiez que l'appareil 2 est en mode bac à sable (étape 1.C), qu'il est connecté avec un compte @gmail.com, qu'il n'est pas rooté/débogué et qu'il exécute les services Play 24.38.xx ou version ultérieure. |
| "Aucune pièce d'identité numérique disponible" lors du test d'une demande | Vérifiez que votre requête inclut com.google.wallet.idcard.1 ou org.iso.23220.photoid.1, et que l'Appareil 2 est toujours en mode bac à sable. |
| La requête échoue avant l'écran de consentement Google Wallet | Vérifiez votre signature JWS, l'en-tête de certificat x5c, client_id (x509_hash) et gw_rp_metadata_bytes. |
Supprimer votre pass d'identité de test de Wallet
Appuyez sur le menu à trois points en haut à droite de l'écran de la pièce d'identité, sélectionnez Supprimer, puis suivez les instructions pour supprimer le pass d'identité de test.