Langkah 2: Buat ID Pengujian di Sandbox

ID pengujian memungkinkan Anda menjalankan alur presentasi lengkap dan memverifikasi bahwa layanan Anda menerima dan memvalidasi respons Google Wallet, tanpa memerlukan tanda pengenal terbitan pemerintah asli. Anda membuat tanda pengenal pengujian dengan memindai ePaspor simulasi ke Google Wallet di perangkat sandbox Anda.

Langkah-langkah di halaman ini

Langkah A: Siapkan dua perangkat Android Anda

Anda memerlukan dua perangkat Android: perangkat pertama menyimulasikan paspor elektronik, dan perangkat kedua adalah tempat Anda menambahkan tanda pengenal digital yang berasal dari paspor elektronik yang disimulasikan.

Proses tiga langkah menggunakan dua ponsel Android dengan NFC untuk menambahkan tanda pengenal digital pengujian Utopia ke Google Wallet

Persyaratan Perangkat 1: Simulator paspor Perangkat 2: Google Wallet pengujian Anda
Jabatan Menyimulasikan ePaspor NFC Menyimpan tanda pengenal digital pengujian di Google Wallet
Langkah-langkah penyiapan
  1. Instal aplikasi Utopia ePassport Simulator.
  2. Buka aplikasi dan tambahkan entri paspor baru. Anda akan memindai entri ini di Langkah B.
  1. Instal atau update aplikasi Google Wallet dari Google Play Store.
  2. Pastikan layanan Google Play adalah versi 24.38.xx atau yang lebih baru (cara memeriksa).
  3. Pastikan perangkat BUKAN perangkat debug atau perangkat yang telah di-root.
  4. Alihkan Google Wallet ke lingkungan Sandbox (melakukan hal ini di perangkat pribadi akan menghapus data produksi yang ada).
  5. Login dengan Akun Google @gmail.com.

Langkah B: Tambahkan ID pengujian ke Wallet

  1. Di Perangkat 2, buka aplikasi Google Wallet dan ketuk Tambahkan ke Wallet.
  2. Pilih Tanda pengenal > Tanda pengenal digital.
  3. Ikuti petunjuk di layar hingga selesai:
    1. Pemindaian MRZ: Di Perangkat 1, ketuk entri yang Anda buat sebelumnya di aplikasi simulator, dan masukkan detail paspor secara manual di Perangkat 2.
    2. Pemindaian NFC: Dekatkan Perangkat 1 (dengan halaman MRZ aplikasi simulator terbuka) ke bagian belakang Perangkat 2 selama pemindaian NFC.

Langkah C: Lihat detail di Wallet

  1. Setelah tanda pengenal digital Anda ada di Google Wallet, ketuk menu tiga titik di sudut kanan atas, lalu pilih Info tanda pengenal digital.
  2. Ketuk opsi yang tercantum dan verifikasi bahwa opsi tersebut berfungsi seperti yang diharapkan—khususnya, buka bagian detail kartu untuk mengonfirmasi bahwa atributnya cocok dengan entri yang Anda buat.

Langkah D: Gunakan ID pengujian Anda dalam permintaan

ID pengujian sandbox Anda adalah tanda pengenal digital. Agar Google Wallet dapat mencocokkan dan menampilkannya, OpenID4VP dcql_query Anda harus meminta jenis dokumen tanda pengenal digital:

  • com.google.wallet.idcard.1 (tanda pengenal digital), atau
  • org.iso.23220.photoid.1 (Tanda pengenal digital yang menggunakan jenis dokumen tanda pengenal berfoto ISO)

Permintaan yang hanya meminta Surat Izin Mengemudi seluler (org.iso.18013.5.1.mDL) tidak akan cocok dengan tanda pengenal digital pengujian Utopia. Untuk menerima kredensial yang memenuhi syarat, gunakan contoh dcql_query multi-kredensial di Langkah 3.A: Format Permintaan, dan periksa Kredensial & Atribut yang Didukung untuk jalur klaim yang tersedia.

Uji tanda pengenal digital baru Anda dalam dua tahap:

  1. Pemeriksaan cepat dengan Alat Verifikasi Web: Buka verifier.multipaz.org di Perangkat 2 (atau di browser desktop untuk pengujian QR lintas perangkat) dan minta tanda pengenal digital. Tindakan ini akan mengonfirmasi bahwa perangkat dan tanda pengenal digital pengujian Anda berfungsi sebelum Anda menguji kode Anda sendiri.
  2. Uji terhadap layanan Anda sendiri: Setelah Anda menyelesaikan Langkah 3, kirim permintaan yang ditandatangani dengan kunci pengujian sandbox (Pihak tepercaya) atau Root CA Sandbox Anda (Verifier Registrar), dan konfigurasikan server Anda untuk memvalidasi issuerAuth terhadap sertifikat Sandbox Utopia.

Pemecahan masalah

Masalah Yang perlu diperiksa
Lingkungan TapAndPay tidak ada di Setelan Akun Google Anda belum ada dalam daftar yang diizinkan untuk sandbox. Lihat Langkah 1.A: Meminta akses sandbox.
Opsi Tanda pengenal digital tidak ditampilkan di bagian Tambahkan ke Wallet Pastikan Perangkat 2 dalam mode sandbox (Langkah 1.C), login dengan akun @gmail.com, tidak di-root/di-debug, dan menjalankan layanan Play 24.38.xx+.
"Tidak ada tanda pengenal digital yang tersedia" saat menguji permintaan Pastikan permintaan Anda menyertakan com.google.wallet.idcard.1 atau org.iso.23220.photoid.1, dan Perangkat 2 masih dalam mode sandbox.
Permintaan gagal sebelum layar izin Google Wallet Verifikasi tanda tangan JWS, header sertifikat x5c, client_id (x509_hash), dan gw_rp_metadata_bytes Anda.

Menghapus tanda pengenal digital pengujian Anda dari Wallet

Ketuk menu tiga titik di kanan atas layar tanda pengenal dan pilih Hapus, lalu ikuti petunjuk untuk menghapus tanda pengenal digital pengujian.

Langkah berikutnya