Credential Manager Holder API, Android cüzdan uygulamanızın dijital kimlik bilgilerini yönetmesine ve doğrulayıcılara sunmasına olanak tanır.
Kimlik bilgisi biçimleri
Kimlik bilgileri, cüzdan uygulamalarında farklı kimlik bilgisi biçimlerinde saklanabilir. Bu biçimler, bir kimlik bilgisinin nasıl temsil edilmesi gerektiğine dair spesifikasyonlardır ve her biri kimlik bilgisiyle ilgili aşağıdaki bilgileri içerir:
- Tür: Üniversite diploması veya sürücü belgesi gibi kategori.
- Özellikler: Ad ve soyadı gibi özellikler.
Kodlama: Kimlik bilgisinin yapılandırılma şekli (ör. SD-JWT veya mdoc)
Geçerlilik: Kimlik bilgisinin gerçekliğini kriptografik olarak doğrulama yöntemi.
Her kimlik bilgisi biçimi, kodlama ve doğrulama işlemlerini biraz farklı şekilde yapar ancak işlevsel olarak aynıdır.
Kayıt defteri iki biçimi destekler:
- SD-JWT: IETF SD-JWT tabanlı Doğrulanabilir Kimlik Bilgileri (SD-JWT VC) spesifikasyonuna uygundur.
- Mobil belgeler veya mdoc'lar: ISO/IEC 18013-5:2021 spesifikasyonuna uygundur.
Doğrulayıcı, Kimlik Bilgisi Yöneticisi'ni kullanırken SD-JWT ve mdoc'lar için OpenID4VP isteğinde bulunabilir. Seçim, kullanım alanına ve sektöre göre değişir.
Kimlik bilgisi meta verilerini kaydetme
Kimlik Bilgisi Yöneticisi, kullanıcının kimlik bilgilerini doğrudan değil, kimlik bilgilerinin meta verilerini depolar. Cüzdan uygulaması, RegistryManager kullanarak kimlik bilgisi meta verilerini önce Kimlik Bilgisi Yöneticisi'ne kaydetmelidir. Bu kayıt işlemi, iki temel amaca hizmet eden bir kayıt defteri kaydı oluşturur:
- Eşleştirme: Kayıtlı kimlik bilgisi meta verileri, gelecekteki doğrulayıcı istekleriyle eşleştirmek için kullanılır.
- Görüntüleme: Özelleştirilmiş kullanıcı arayüzü öğeleri, kimlik bilgisi seçici arayüzünde kullanıcıya gösterilir.
Hem mdoc hem de SD-JWT kimlik bilgisi biçimlerini desteklediği için dijital kimlik bilgilerinizi kaydetmek üzere OpenId4VpRegistry sınıfını kullanın. Doğrulayıcılar, bu kimlik bilgilerini istemek için OpenID4VP istekleri gönderir.
Kimlik bilgisi verme yöntemleri
Kimlik bilgisi verme işlemi iki şekilde tetiklenebilir:
- Veren tarafından başlatılan akış: Kullanıcı, veren kuruluşun uygulamasından veya web sitesinden VDC verilmesi için bir istek tetikler. Örneğin, bir web sitesi kullanıcılarına "Pasaportunuzu cüzdanınıza ekleyin" seçeneği sunabilir. Veren, OpenID4VCI kimlik bilgisi teklifi isteğinde bulunmak için Kimlik Bilgisi Yöneticisi verme API'sini çağırır. Bu tür istekleri işlemek için, kart sahibinin önce meta verilerini kaydetmek üzere Kimlik Bilgisi Yöneticisi ile entegre olması gerekir. Kimlik Bilgisi Yöneticisi, kullanıcının seçebileceği alakalı seçenekleri gösterir. Kullanıcı bir cüzdan seçeneği belirledikten sonra cüzdan uygulaması çağrılır ve kart verme işlemini tamamlamak için gereken adımlara devam edebilir.
- Kart sahibi tarafından başlatılan akış: Kullanıcı, kart sahibi uygulamasından VDC ekleme isteğinde bulunur. Örneğin, bir kart sahibi "Pasaportunuzu ekleyin" düğmesi sunabilir. Bu durumda, kart sahibi desteklenen veren listesini ve meta verilerini korur. Bu işlevi tamamlamak için Android Kimlik Bilgisi Yöneticisi ile entegre olması gerekmez.