FAQ Identitas & Kredensial Digital

Halaman ini menjawab pertanyaan umum (FAQ) tentang integrasi dengan Google Wallet untuk Identitas dan Kredensial Digital.

Orientasi & Memulai

T: Bagaimana proses langkah demi langkah bagi partner baru untuk bergabung sebagai Pihak Pengguna (RP)?

J: Ikuti panduan langkah demi langkah di: Pilih Jalur Anda.

T: Berapa durasi umum untuk proses aktivasi RP?

J: Biasanya, orientasi memerlukan waktu 3-5 hari kerja.

T: Bagaimana cara melacak status permohonan Pihak Pengandalkan (RP) kami setelah dikirimkan?

J: Jika Anda belum menerima balasan setelah 5 hari, hubungi tim dukungan kami di wallet-identity-rp-support@google.com.

T: Di mana kami dapat menemukan formulir aktivasi RP dan dokumentasi developer resmi?

A:

T: Bagaimana informasi yang kami berikan (seperti Nama dan Logo Produk) akan digunakan dalam pengalaman produk?

J: Nama dan Logo Produk ditampilkan di layar izin yang ditampilkan kepada pengguna untuk membantu pengguna mengidentifikasi Pihak Pengandalkan yang meminta ID digital mereka. URL dan link kebijakan juga dapat ditampilkan dalam pengalaman produk.

T: Apakah kami perlu menandatangani Persyaratan Layanan jika kami hanya berencana menggunakan lingkungan sandbox untuk pengembangan dan pengujian?

J: Tidak, menyetujui Persyaratan Layanan bukanlah langkah yang diperlukan untuk pengujian.

T: Di mana kami dapat menemukan implementasi referensi, kode contoh, atau aplikasi demo untuk memulai?

A:


Registrar Pemverifikasi

T: Apa yang dimaksud dengan Registrar Pemverifikasi dan bagaimana cara kerjanya?

J: Verifier Registrar bertindak sebagai Certificate Authority yang melakukan aktivasi klien downstream (RP Akhir). RP Akhir tidak berinteraksi langsung dengan Google Wallet.

T: Bagaimana proses orientasi khusus untuk Registrar Pemverifikasi dan klien downstream-nya?

J: Lihat langkah-langkahnya di: Panduan Registrar Pemverifikasi.

T: Apa perbedaannya dengan integrasi RP langsung?

J: Registrar Pemverifikasi mengelola hubungan kepercayaan untuk klien mereka dan menangani integrasi dengan Google Wallet atas nama mereka, sedangkan RP langsung mengelola konfigurasi mereka sendiri dengan Google.

T: Di Verifier Registrar, siapa yang diizinkan dalam konfigurasi Google: Verifier Registrar, RP akhir, atau keduanya?

J: Google mengizinkan sertifikat Root CA Verifier Registrar. Verifier Registrar kemudian menerbitkan sertifikat entitas akhir baru untuk setiap RP Akhir downstream.

T: Bagaimana aliran data antara RP akhir, Registrar Pemverifikasi, dan Google Wallet?

A: Registrar Pemverifikasi mengirimkan permintaan API ke Google Wallet untuk RP Akhir. Google Wallet menampilkan data kredensial terenkripsi ke Registrar Pemverifikasi, yang kemudian memprosesnya dan mengirimkan sinyal akhir ke RP Akhir.

J: Tidak. Registrar Pemverifikasi dapat memilih untuk tidak menampilkan detailnya.

T: Apa saja jenis kunci dan kurva yang diizinkan untuk Root CA dan Sertifikat RP?

A: Sertifikat harus dibuat menggunakan P-256/ECDSA.

T: Dapatkah kami menggunakan sertifikat penanda tangan perantara antara Root CA dan sertifikat entitas akhir RP kami?

J: Ya. Anda dapat menyimpan root certificate yang berumur panjang dengan aman (misalnya, di HSM) untuk menandatangani intermediate certificate operasional yang jarang digunakan. Sertifikat perantara tersebut kemudian dapat digunakan untuk menandatangani sertifikat entitas akhir RP akhir, sehingga memudahkan rotasi jika terjadi pelanggaran tanpa memengaruhi root.

T: Berapa masa berlaku yang diperlukan untuk sertifikat?

J: Masa berlaku 10 tahun sangat dapat diterima untuk sertifikat Root CA. Sertifikat entitas akhir RP akhir umumnya harus mengikuti jangka waktu perpanjangan ~1 tahun untuk memastikan sertifikat tersebut dapat dirotasi secara efisien jika terjadi masalah.

T: Apakah kita perlu mengelola sertifikat entitas akhir terpisah untuk setiap pelanggan Relying Party (RP)?

J: Ya. Untuk periode peluncuran awal, agregator harus mengelola sertifikat terpisah untuk setiap RP downstream. Hal ini memungkinkan konfigurasi tampilan per RP dan pelacakan penyalahgunaan yang akurat. Meskipun hal ini menambah overhead operasional dalam skala besar, kami bermaksud untuk meninjau kembali alternatif potensial (seperti menggunakan hash metadata RP) setelah peluncuran awal.

T: Apakah partner diizinkan memiliki beberapa sertifikat aktif secara bersamaan?

J: Ya, konfigurasi ini mendukung berapa pun jumlah sertifikat aktif per RP atau agregator, yang berguna bagi partner yang beroperasi dengan berbagai nama bisnis.

T: Bagaimana seharusnya Distinguished Name (Subjek) diformat?

J: Nama yang Dibedakan harus unik secara global per partner. ID ini berfungsi sebagai ID statis yang digunakan Google untuk memantau permintaan partner yang masuk dan memastikan kepercayaan ekosistem.

T: Bagaimana cara kerja pengikatan domain? Apakah origin perlu disematkan dalam sertifikat?

J: Domain tidak perlu disematkan langsung dalam sertifikat itu sendiri. Sebagai gantinya, verifikasi domain dilakukan menggunakan parameter asal yang diharapkan dalam panggilan API. Selain itu, beberapa domain dapat dikaitkan dengan lancar ke satu sertifikat. Untuk permintaan yang tidak ditandatangani, binding dijalankan menggunakan nama paket Domain atau Aplikasi bersama dengan sidik jari.

T: Dapatkah detail agregator dihilangkan dari UI verifikasi untuk pengalaman berlabel putih?

J: Ya, informasi gabungan (seperti nama, logo, URL, dan kebijakan privasi) sepenuhnya bersifat opsional dalam metadata pemverifikasi. Hal ini memungkinkan solusi label putih sepenuhnya, yang hanya menampilkan detail RP akhir kepada pengguna.

T: Apa yang perlu kami sediakan untuk mulai melakukan pengujian di lingkungan Sandbox?

J: Dari sudut pandang teknis, Anda hanya perlu memberikan Root Certificate Sandbox. Sandbox dirancang untuk mencerminkan lingkungan produksi secara identik.

T: Apa perbedaan proses aktivasi untuk Registrar Pemverifikasi (Agregator) dibandingkan dengan RP langsung?

J: Agregator menjalani proses yang sedikit dimodifikasi. Setelah menyetujui Persyaratan Layanan Verifier Registrar tertentu, proses pendaftaran dibagi menjadi dua bagian: formulir utama untuk menetapkan status Anda sebagai Verifier Registrar, diikuti dengan formulir yang disederhanakan yang diperlukan untuk setiap RP yang Anda daftarkan. Setiap pengiriman RP biasanya memerlukan rekaman video integrasi, dan proses peninjauan biasanya memerlukan waktu 2-3 hari kerja.

T: Dapatkah kami mengaktifkan pelanggan yang berniat bertindak sebagai perantara atau menjual kembali layanan verifikasi kepada entitas lain?

J: Tidak. Model dan preferensi Google saat ini adalah bekerja sama langsung dengan Registrar Pemverifikasi (agregator) dan RP akhir langsung mereka, bukan mendukung model reseller atau perantara bertingkat.


Integrasi Teknis & API

T: Apa protokol yang mendasari permintaan? Versi apa saja yang didukung?

J: Protokol utamanya adalah OpenID for Verifiable Presentations (OpenID4VP) versi 1.0.

T: Lampiran ISO 18013-7 mana (misalnya, Lampiran B, C, D) yang didukung Google untuk presentasi mDL?

J: Google mendukung Annex D [saat ini dalam draf] (OpenID4VP menggunakan DC API).

T: Bagaimana cara menyusun permintaan API dengan benar untuk meminta beberapa kredensial dalam satu presentasi pengguna?

J: Kedua jenis kredensial harus diminta dalam satu objek kueri dcql dalam permintaan JSON yang sama.

T: Apakah API mengizinkan permintaan kredensial generik tanpa mencantumkan setiap jenis kredensial yang mungkin?

J: Tidak.

T: Bagaimana cara API menangani verifikasi usia? Dapatkah kami meminta tanggal lahir yang tepat, atau hanya sinyal "di atas X"?

J: Keduanya didukung. Anda dapat meminta birth_date, age_in_years, atau sinyal "lebih dari X" yang menjaga privasi. Zero-Knowledge Proof (ZKP) juga dapat digunakan untuk sinyal benar/salah.

T: Apa saja persyaratan untuk infrastruktur PKI kami?

J: RP memerlukan PKI untuk menandatangani permintaan. Registrar Pemverifikasi bertindak sebagai CA mereka sendiri.

T: Dapatkah kami menggunakan sertifikat yang sudah ada, atau apakah kami perlu mendapatkan sertifikat baru yang ditandatangani oleh Google?

J: RP memerlukan sertifikat baru yang ditandatangani oleh Google atau Verifier Registrar. Untuk Registrar Pemverifikasi, Google akan memercayai Root certificate Anda jika Anda mengikuti langkah-langkah "Pembentukan Kepercayaan" dalam dokumentasi.

J: Seluruh permintaan harus dibuat di sisi server. Di Android, gunakan Credman API; di web, gunakan Digital Credentials (DC) API.

T: Alat proses debug, logging, dan kemampuan observasi apa yang tersedia untuk developer?

J: Partner dapat menggunakan alias dukungan wallet-identity-rp-support@google.com. Tidak ada alat logging atau kemampuan observasi khusus yang disediakan.


Kredensial & Data

T: Tanda pengenal digital, penerbit, dan kredensial mana yang didukung menurut negara dan wilayah?

J: Temukan wilayah yang didukung di sini: Penerbit dan Sertifikat yang Didukung.

T: Kapan Anda berencana mendukung kredensial dari negara atau wilayah baru?

J: Kami terus menambahkan wilayah baru; periksa halaman penerbit yang didukung untuk mengetahui info terbaru.

T: Saat kredensial diperbarui oleh penerbit, apakah pengguna akhir akan menerima notifikasi?

A: Ya, pengguna akan diberi tahu dan update akan diterapkan secara otomatis.


Pengujian & Lingkungan

T: Bagaimana cara mendapatkan akses ke lingkungan sandbox untuk menguji alur menyeluruh yang lengkap?

J: Sandbox dapat diakses di: Mode Sandbox.

T: Bagaimana proses bagi partner yang tidak berada di wilayah yang diluncurkan secara resmi untuk ditambahkan ke daftar yang diizinkan untuk pengujian?

J: Kirim email berisi ID Gmail dompet pengujian ke wallet-identity-rp-support@google.com.

T: Bagaimana proses untuk mengaktifkan situs atau aplikasi pengujian untuk tujuan demo, sehingga siapa pun yang memiliki kredensial produksi dapat mempresentasikannya?

J: Partner harus menyelesaikan orientasi RP standar, termasuk demonstrasi video sandbox.


Pengalaman Pengguna (UX)

T: Bagaimana pengalaman pengguna jika pengguna tidak memiliki tanda pengenal digital atau aplikasi Google Wallet yang diinstal saat mereka memulai alur verifikasi?

Pengguna yang tidak memiliki aplikasi akan diarahkan ke Google Play Store. Pengguna yang tidak memiliki ID dapat membuatnya dalam alur menggunakan UI setengah layar.

T: Dapatkah kami mendeteksi secara terprogram apakah pengguna memiliki tanda pengenal digital di Wallet mereka sebelum menampilkan opsi verifikasi kepada mereka?

J: Tidak, API harus dipanggil oleh pengguna untuk melindungi privasi.

T: Dapatkah kami mewajibkan pengguna membuka kunci perangkat mereka dengan biometrik sebelum menampilkan kredensial?

J: Autentikasi pengguna (biometrik, PIN, atau pola) diperlukan secara default dan tidak dapat dinonaktifkan.

J: Tidak, Google Wallet mengurutkannya ulang menurut abjad.


Keamanan & Kepatuhan

T: Kasus penggunaan kami melibatkan pembagian ulang data pengguna kepada pihak ketiga. Apakah hal ini diizinkan berdasarkan Persyaratan Layanan?

J: Ya, pembatasan mungkin berlaku, lihat persyaratan layanan kami untuk mengetahui detail selengkapnya.

T: Dokumentasi apa yang tersedia terkait keamanan, keandalan, dan aksesibilitas solusi identitas digital untuk tujuan kepatuhan kami?

J: Partner dapat merujuk ke peninjauan keamanan Trail of Bits.


Fitur Lanjutan & Roadmap

T: Apa saja kemampuan Zero-Knowledge Proofs (ZKP) untuk verifikasi usia yang menjaga privasi?

J: Zero-Knowledge Proof (ZKP) adalah metode kriptografi yang memungkinkan seseorang (pembukti) membuktikan kepada pemverifikasi bahwa ia memiliki informasi identitas tertentu atau memenuhi kriteria tertentu (misalnya, berusia di atas 18 tahun, memiliki kredensial yang valid) tanpa mengungkapkan data pokok yang sebenarnya.

T: Bagaimana berbagai versi sirkuit ZK ditangani?

J: RP harus menerapkan layanan pemverifikasi ZK untuk meminta sirkuit terbaru yang tersedia.

T: Bagaimana cara kerja berbagi dan pengelolaan kredensial di beberapa perangkat, seperti ponsel dan perangkat wearable?

A: Kredensial disediakan untuk satu perangkat dan tidak dapat dibagikan.


Lainnya

T: Bagaimana cara Google menangani pencabutan tanda pengenal digital jika paspor dicabut?

J: Pengguna dapat menghapus kartu dari setelan Akun Google; perangkat yang hilang dapat dilaporkan untuk mencabut kredensial.

T: Bagaimana cara menangani pencabutan mDL? Apakah proses tersebut dilakukan secara real-time?

J: Pembaruan dapat dipicu oleh pengguna atau dikirim oleh penerbit (DMV). Proses ini bersifat real-time jika perangkat sedang online; jika tidak, objek keamanan berumur pendek (MSO) akan habis masa berlakunya.

T: Apa kebijakan rotasi kunci untuk RP?

J: Rotasi tahunan direkomendasikan.

T: Berapa versi Android minimum yang didukung untuk Digital Credentials API?

J: Android 9 (level API 28) dan yang lebih tinggi.

T: Berapa versi Chrome minimum yang mendukung Digital Credentials API?

J: Chrome versi 128 dan yang lebih baru.

T: Browser mana yang mendukung Digital Credentials API?

J: Anda dapat menemukan detail dukungan browser di sini: https://digitalcredentials.dev/ecosystem-support

T: Pengguna mana yang akan memiliki kemampuan untuk menambahkan ID saat negara baru diluncurkan?

J: Akses didasarkan pada setelan negara pengguna di Google Play Store.

T: Apakah Digital Credentials API berfungsi dengan iOS?

J: Ya, API ini berfungsi menggunakan browser yang didukung seperti Safari. Namun, OpenID4VP tidak didukung oleh Apple.