Schritt 2: Test-ID in der Sandbox erstellen

Mit einem Testausweis können Sie den gesamten Präsentationsablauf durchlaufen und prüfen, ob Ihr Dienst eine Google Wallet-Antwort akzeptiert und validiert, ohne dass ein echter amtlicher Ausweis erforderlich ist. Sie erstellen den Testausweis, indem Sie einen simulierten ePass auf Ihrem Sandbox-Gerät in Google Wallet scannen.

Start

Wähle deinen Weg RP, VR oder persönlich

1
Sandbox einrichten Konto auf die Zulassungsliste setzen und Gerät wechseln
2Hier
Test-ID erstellen digitalen Identitätsnachweis zu Wallet hinzufügen
3
Integrieren Wählen Sie Ihren Pfad:
Relying Party→ Verifier Registrar→
4
Integration testen E2E-Checkliste ausführen und Video aufnehmen
5
Live gehen Nach Pfad starten:
Relying Party→ Verifier Registrar→

Schritte auf dieser Seite

A Zwei Geräte einrichtenSimulator-Smartphone + Sandbox-Wallet-Smartphone B Testausweis zu Wallet hinzufügenMRZ scannen und per NFC tippen C Ausweis in Wallet prüfenKartendetails in Google Wallet prüfen D Digitalen Identitätsnachweis verwendenDoctype für digitalen Identitätsnachweis anfordern und Ablauf testen

Schritt A: Android-Geräte einrichten

Sie benötigen zwei Android-Geräte: Das erste Gerät simuliert einen ePass und auf dem zweiten Gerät fügen Sie den digitalen Identitätsnachweis hinzu, der vom simulierten ePass abgeleitet wurde.

Dreistufiger Prozess mit zwei Android-Smartphones mit NFC, um Google Wallet einen Utopia-Testausweis hinzuzufügen

Anforderung Gerät 1: Passport-Simulator Gerät 2: Ihr Google Wallet-Testkonto
Rolle Simuliert einen NFC-ePass Enthält den Test-ID-Ausweis in Google Wallet
Einrichtungsschritte
  1. Installieren Sie die Utopia ePassport Simulator App.
  2. Öffnen Sie die App und fügen Sie einen neuen Pass hinzu. Sie scannen diesen Eintrag in Schritt B.
  1. Installieren oder aktualisieren Sie die Google Wallet App über den Google Play Store.
  2. Prüfen Sie, ob die Google Play-Dienste die Version 24.38.xx oder höher haben (Anleitung).
  3. Prüfe, ob es sich bei dem Gerät NICHT um ein Debug- oder gerootetes Gerät handelt.
  4. Wechseln Sie in Google Wallet zur Sandbox-Umgebung. Wenn Sie dies auf einem privaten Gerät tun, werden vorhandene Produktionsdaten gelöscht.
  5. Melden Sie sich mit einem Google-Konto mit der Endung @gmail.com an.

Schritt B: Test-ID zu Wallet hinzufügen

  1. Öffnen Sie auf Gerät 2 die Google Wallet App und tippen Sie auf Zu Wallet hinzufügen.
  2. Wählen Sie Ausweis > Digitaler Identitätsnachweis aus.
  3. Folge der Anleitung auf dem Bildschirm, bis der Vorgang abgeschlossen ist:
    1. MRZ-Scan: Tippe auf Gerät 1 auf den Eintrag, den du zuvor in der Simulator-App erstellt hast, und gib die Passdaten manuell auf Gerät 2 ein.
    2. NFC-Scan:Halte Gerät 1 (mit der MRZ-Seite der Simulator-App geöffnet) während des NFC-Scans an die Rückseite von Gerät 2.

Schritt C: Details in Wallet ansehen

  1. Wenn sich Ihr digitaler Identitätsnachweis in Google Wallet befindet, tippen Sie rechts oben auf das Dreipunkt-Menü und wählen Sie Informationen zum digitalen Identitätsnachweis aus.
  2. Tippe dich durch die aufgelisteten Optionen und prüfe, ob sie wie erwartet funktionieren. Öffne insbesondere den Abschnitt mit den Kartendetails, um zu bestätigen, dass die Attribute mit dem von dir erstellten Eintrag übereinstimmen.

Schritt D: Test-ID in Anfragen verwenden

Ihre Sandbox-Test-ID ist ein digitaler Identitätsnachweis. Damit Google Wallet das Dokument abgleichen und präsentieren kann, muss Ihr OpenID4VP-dcql_query einen Dokumenttyp für den digitalen Identitätsnachweis anfordern:

  • com.google.wallet.idcard.1 (digitaler Identitätsnachweis) oder
  • org.iso.23220.photoid.1 (digitaler Identitätsnachweis mit dem ISO-Dokumenttyp „Lichtbildausweis“)

Eine Anfrage, bei der nur ein digitaler Führerschein (org.iso.18013.5.1.mDL) angefordert wird, stimmt nicht mit dem Utopia-Testausweis überein. Wenn Sie alle zulässigen Ausweise akzeptieren möchten, verwenden Sie das Beispiel für mehrere Ausweise (dcql_query) in Schritt 3.A: Anfrage formatieren und prüfen Sie die verfügbaren Anspruchspfade unter Unterstützte Ausweise und Attribute.

Testen Sie Ihren neuen digitalen Identitätsnachweis in zwei Phasen:

  1. Schnellprüfung mit dem Web Verifier Tool:Öffne verifier.multipaz.org auf Gerät 2 (oder in einem Desktop-Browser für geräteübergreifende QR-Tests) und fordere einen digitalen Identitätsnachweis an. So können Sie prüfen, ob Ihr Gerät und der digitale Identitätsnachweis funktionieren, bevor Sie Ihren eigenen Code testen.
  2. Mit Ihrem eigenen Dienst testen: Nachdem Sie Schritt 3 abgeschlossen haben, senden Sie eine Anfrage, die mit den Sandbox-Testschlüsseln (Relying Parties) oder Ihrer Sandbox-Root-CA (Verifier Registrars) signiert ist, und konfigurieren Sie Ihren Server so, dass issuerAuth mit dem Utopia-Sandbox-Zertifikat validiert wird.

Fehlerbehebung

Problem Zu prüfen
TapAndPay Environment fehlt in den Einstellungen Ihr Google-Konto steht noch nicht auf der Sandbox-Zulassungsliste. Weitere Informationen finden Sie unter Schritt 1.A: Sandbox-Zugriff anfordern.
Die Option Digitaler Identitätsnachweis wird unter Zu Wallet hinzufügen nicht angezeigt. Prüfe, ob sich Gerät 2 im Sandbox-Modus befindet (Schritt 1.C), mit einem @gmail.com-Konto angemeldet ist, nicht gerootet ist und nicht im Debug-Modus ausgeführt wird und ob die Google Play-Dienste in Version 24.38.xx oder höher installiert sind.
„Kein digitaler Ausweis verfügbar“ beim Testen einer Anfrage Prüfe, ob deine Anfrage com.google.wallet.idcard.1 oder org.iso.23220.photoid.1 enthält und ob sich Gerät 2 noch im Sandbox-Modus befindet.
Anfrage schlägt vor dem Google Wallet-Zustimmungsbildschirm fehl Prüfen Sie Ihre JWS-Signatur, den x5c-Zertifikatsheader, client_id (x509_hash) und gw_rp_metadata_bytes.

Digitalen Identitätsnachweis aus Wallet löschen

Tippe auf dem Bildschirm mit dem digitalen Identitätsnachweis oben rechts auf das Dreipunkt-Menü und wähle Löschen aus. Folge dann der Anleitung, um den Test-digitalen Identitätsnachweis zu entfernen.

Nächster Schritt

Schritt 3 (Relying Party): Integrieren → Schritt 3 (Verifier Registrar): Integrieren →