Credential Manager Holder API memungkinkan aplikasi pemegang Android (juga disebut "dompet") mengelola dan menampilkan kredensial digital kepada pemverifikasi.
Format kredensial
Kredensial dapat disimpan di aplikasi pemegang dalam berbagai format kredensial. Format ini adalah spesifikasi untuk cara kredensial harus direpresentasikan, dan masing-masing berisi informasi berikut tentang kredensial:
- Jenis: Kategori seperti gelar universitas atau surat izin mengemudi.
- Properti: Atribut seperti nama depan dan belakang.
Encoding: Cara kredensial disusun, misalnya SD-JWT atau mdoc
Validitas: Metode untuk memverifikasi keaslian kredensial secara kriptografis.
Setiap format kredensial melakukan encoding dan validasi dengan sedikit berbeda, tetapi secara fungsional sama.
Registry mendukung dua format:
- SD-JWT: sesuai dengan spesifikasi Kredensial yang Dapat Diverifikasi berbasis SD-JWT (SD-JWT VC) IETF.
- Dokumen Seluler atau mdoc: sesuai dengan spesifikasi ISO/IEC 18013-5:2021.
Pemverifikasi dapat membuat permintaan OpenID4VP untuk SD-JWT dan mdoc saat menggunakan Credential Manager. Pilihannya bervariasi, bergantung pada kasus penggunaan dan pilihan industri.
Pendaftaran metadata kredensial
Credential Manager tidak menyimpan kredensial pemegang secara langsung, melainkan metadata kredensial. Aplikasi pemegang harus mendaftarkan metadata kredensial terlebih dahulu
dengan Credential Manager menggunakan RegistryManager. Proses pendaftaran ini
membuat data registry yang memiliki dua tujuan utama:
- Pencocokan: Metadata kredensial yang terdaftar digunakan untuk mencocokkan dengan permintaan verifikasi mendatang.
- Tampilan: Elemen UI yang disesuaikan ditampilkan kepada pengguna di antarmuka pemilih kredensial.
Gunakan class OpenId4VpRegistry untuk mendaftarkan kredensial digital Anda,
karena class ini mendukung format kredensial mdoc dan SD-JWT. Pemverifikasi akan mengirimkan
permintaan OpenID4VP untuk meminta kredensial ini.
Metode penerbitan kredensial
Penerbitan kredensial dapat dipicu dengan dua cara:
- Alur yang dimulai penerbit: pengguna memicu permintaan untuk menerbitkan VDC dari aplikasi atau situs penerbit. Misalnya, situs dapat menawarkan opsi kepada penggunanya untuk "Menambahkan paspor ke dompet". Penerbit memanggil Credential Manager issuance API untuk membuat permintaan Penawaran Kredensial OpenID4VCI. Untuk menangani permintaan tersebut, pemegang harus terlebih dahulu berintegrasi dengan Credential Manager untuk mendaftarkan metadatanya. Pengelola Kredensial akan menampilkan opsi yang relevan untuk dipilih pengguna. Setelah pengguna memilih opsi pemegang, aplikasi pemegang akan dipanggil dan dapat melanjutkan langkah-langkah yang diperlukan untuk menyelesaikan penerbitan.
- Alur yang dimulai pemegang: pengguna meminta untuk menambahkan VDC dari aplikasi pemegang. Misalnya, pemegang dapat menawarkan tombol untuk "Menambahkan paspor Anda". Dalam hal ini, pemegang mengelola daftar penerbit dan metadata yang didukungnya. Aplikasi ini tidak perlu berintegrasi dengan Pengelola Kredensial Android untuk menyelesaikan fungsi ini.