4. Adım: Entegrasyonunuzu test edin

Üretimde yayına geçmeden önce, dijital kimliğinizi kullanarak entegrasyonunuzun korumalı alanda uçtan uca çalıştığını doğrulayın ve ardından tüm akışın tanıtım videosunu kaydedin. Google, ilk katılımın 5. adımında bu videoyu inceler.

Başlat

Yolunuzu seçin RP, Doğrulayıcı Kayıt Sorumlusu veya Yüz Yüze

1
Korumalı alanı ayarlama Hesabı izin verilenler listesine ekleme ve cihazı değiştirme
2
Test kimliği oluşturma Cüzdan'a test dijital kimlik ekleme
3
Entegre edin Kendi yolunuzu oluşturun:
Relying Party→ Verifier Registrar→
4Here
Entegrasyonu test etme Uçtan uca yapılacaklar listesini çalıştırma ve video kaydetme
5
Canlı kullanıma geçme Kendi yolunuzu seçerek başlayın:
Relying Party→ Verifier Registrar→

Bu sayfadaki adımlar

A Korumalı alan kurulumunu kontrol edinCihaz, test kimliği, imzalama anahtarları ve IACA kökü B İsteği ve kullanıcı deneyimi akışını test edinSeçiciyi, kullanıcı rızası ekranını ve hataları doğrulayın C Sunucu doğrulamasını test edinJWE şifre çözme ve IACA imzalarını doğrulayın D Uçtan uca video kaydedinRP veya VR onayı için demo kaydedin

Temel test referansları

Desteklenen Kimlik Bilgileri ve Özellikler

mDL'ler, dijital kimlikler ve fotoğraflı kimliklerde desteklenen tam doctype_value tanımlayıcıları ve talep yollarını kontrol edin.

Desteklenen Kart Sağlayıcı Kuruluşlar ve IACA Sertifikaları

Üretim sertifikası veren kuruluşun IACA kök sertifikalarını ve Utopia Sandbox sertifikasını indirin.

Etkileşimli Web Doğrulama Aracı

Entegrasyonunuzu OpenWallet Foundation'ın barındırılan referans doğrulayıcısıyla yan yana karşılaştırın.

A adımı: Korumalı alan test kurulumunuzu doğrulayın

Uçtan uca testinizi çalıştırmadan önce bu dört ön koşulun karşılandığından emin olun:

  1. Test kimliğiyle korumalı alan modunda olan cihaz: Android test cihazınız KORUMALI ALAN moduna geçirilir (1. adım) ve Google Cüzdan'a Utopia kimlik kartı eklenir (2. adım).
  2. Korumalı alan isteği imzalama:
    • Bağlı Taraflar: Sunucunuz, istekleri önceden güvenilen Özel Korumalı Alan Test Anahtar Çifti ve Meta Verileri ile imzalar.
    • Doğrulayıcı Kayıt Operatörleri: Google, korumalı alan kök CA'nızın korumalı alan güvenilir sertifika deposunda olduğunu ve sunucunuzun, korumalı alan kök CA'nıza zincirlenmiş bir yaprak sertifikayla istekleri imzaladığını ve CBOR ile kodlanmış gw_rp_metadata_bytes (3.A Adımı: VR Spesifikasyonları) içerdiğini onaylamıştır.
  3. İstek, bir dijital kimlik belge türü içerir: Korumalı alan test kimliği bir dijital kimlik olduğundan dcql_query, com.google.wallet.idcard.1 veya org.iso.23220.photoid.1 isteğinde bulunur (ya da 3.A adımındaki çoklu kimlik bilgisi isteğini kullanır).
  4. Sunucu, Utopia Sandbox sertifikasına güveniyor: Sunucunuzun güvenilir sertifika deposu, Utopia Sandbox sertifikasını içerir. Bu nedenle, Utopia test kimliği için issuerAuth imza doğrulaması başarılı olur.

B adımı: İsteği, kullanıcı deneyimini ve hata işlemeyi test edin

Desteklediğiniz her platformda (Android uygulaması, mobil web ve masaüstü cihazlar arası web) aşağıdaki kontrollerin her birini gerçekleştirin:

  • Görünür giriş noktası: Kullanıcı dokunduğunda/tıkladığında isteği başlatan net bir düğme (ör. "Dijital kimlikle doğrula").
  • Android uygulaması (varsa): CredentialManager.getCredential(), Android kimlik bilgisi seçiciyi açar ve korumalı alan test kimlik kartınızı gösterir.
  • Web (varsa): navigator.credentials.get(), mobil tarayıcılarda kimlik bilgisi seçiciyi açar ve imzalı istekler kullanılırken masaüstü tarayıcılarda cihazlar arası QR kodunu gösterir.
  • Google Cüzdan kullanıcı rızası ekranı: Kimlik bilgisine dokunulduğunda Google Cüzdan açılır ve gw_rp_metadata_bytes uygulamanızdan beklenen görünen ad, logo ve gizlilik politikası bağlantısı ile yalnızca istediğiniz özellikler gösterilir.
  • Veri minimizasyonu: Yalnızca kullanım alanınız için gerekli olan özellikler istenir (Desteklenen Kimlik Bilgileri ve Özellikler bölümüne bakın) ve her talep için intent_to_retain doğru şekilde ayarlanır.
  • Kullanıcı iptali ve yedek: Sayfanın iptal edilmesi (Android'de GetCredentialCancellationException veya web'de reddedilen bir promise) ya da eşleşme kimliği olmadan test etme (NoCredentialException) kullanıcı arayüzünüzde sorunsuz bir şekilde işlenir.

C adımı: Sunucu tarafı şifre çözme ve kriptografik doğrulamayı test etme

Google Cüzdan'da kullanıcı rızası ekranını onayladıktan sonra sunucunuzun gerekli tüm kriptografik kontrolleri yaptığını doğrulayın:

  • JWE şifre çözme: Sunucunuz, client_metadata.jwks şifreleme ortak anahtarına karşılık gelen özel anahtarı kullanarak döndürülen identityToken değerinin şifresini çözer ve vp_token değerini çıkarır.
  • SessionTranscript yeniden oluşturma: Sunucunuz, tam istek nonce, şifreleme JWK parmak izi ve platform kaynağı (android:apk-key-hash:... veya web kaynağı URL'si) ile OpenID4VPDCAPIHandover kullanarak SessionTranscript değerini yeniden oluşturur.
  • IACA sertifika zinciri doğrulaması (issuerAuth): Sunucunuz, veren sertifika zincirini issuerAuth öğesinden çıkarır ve korumalı alandaki Utopia korumalı alan sertifikasına ve üretim için Desteklenen Verenler ve IACA Sertifikaları bölümündeki resmi üretim kök sertifikalarına göre doğrular. Bu kontrolü hiçbir zaman atlamayın.
  • MSO, ValueDigests ve deviceSignature doğrulaması: Sunucunuz, Mobil Güvenlik Nesnesi (MSO) imzasını doğrular, ValueDigests değerinin döndürülen veri öğeleriyle eşleştiğini onaylar ve deviceSignature değerini doğrular (ISO/IEC 18013-5 bölüm 9.1.2 ve 9.1.3).
  • Sıfır Bilgi Kanıtları (uygulanmışsa): mso_mdoc_zk isteğinde bulunuluyorsa sunucunuz, döndürülen kanıtı longfellow-zk kullanarak doğrular.

D adımı: Baştan sona tanıtım videonuzu kaydedin

Entegrasyonunuz B ve C adımlarını geçtikten sonra, uygulamanızdan veya web sitenizden Google Cüzdan iznine ve doğrulanmış durumunuza geri dönen tüm kullanıcı yolculuğunu gösteren bir ekran görüntüsü videosu kaydedin. Aşağıdaki tabloda, ilk katılım yolunuza göre neleri dahil etmeniz gerektiği gösterilmektedir:

Video şartı Güvenen Taraflar (Doğrudan) Doğrulayıcı Kayıt Şirketleri (Toplayıcılar)
Gösterilecek ekranlar Tam kullanıcı yolculuğu: giriş ekranı → kimlik bilgisi seçici → Google Cüzdan rızası ve kimlik doğrulama → uygulamanızda veya sitenizde doğrulanmış sonuç İlk (1.) alt düzey Güvenen Tarafınız için tam kullanıcı yolculuğu
Kaydedilecek akışlar Android uygulamanız ve/veya web entegrasyonu akışınız Uygun şekilde hem doğrulayıcı tarafından barındırılan (kendi kendine barındırılan) hem de satıcı tarafından barındırılan (RP tarafından barındırılan) akışlar
Markalama ve görüntülü reklam öğeleri Gerçek görünen adınız, logonuz ve gizlilik politikası / Hizmet Şartları URL'leriniz Gerçek satıcı reklam öğeleri (ad, logo, Hizmet Şartları URL'si) ve toplayıcı reklam öğeleriniz

Sonraki adım

Videonuzu göndermek ve yayına almak için oryantasyon yolunuzu seçin:

5. adım (Güvenen Taraf): Canlıya geçme → 5. adım (Doğrulayıcı Kayıt Operatörü): Canlıya geçme →