Digital Credentials API kaynak denemesiyle tanışın

Eiji Kitamura

Yayınlanma tarihi: 4 Eylül 2024, Son güncelleme: 16 Ekim 2024

Chrome 128'den itibaren Digital Credentials API için kaynak denemesi başlatılıyor. Dijital Kimlik Bilgileri API'si, web sitelerinin dijital cüzdanda saklanan sürücü belgesi veya nüfus cüzdanı gibi dijital kimlik bilgileri aracılığıyla kullanıcı hakkında doğrulanabilir bilgiler seçerek istemesine olanak tanıyan yeni bir web platformu API'sidir.

Arka plan

Birçok kamu ve özel kuruluşun cihaza bağlı dijital kimlik bilgileri vermeye başlamasıyla gerçek dünyada dijital kimlik gerçek olmaya başlıyor. Örneğin, belirli ABD eyaletlerindeki (ör. Arizona, California, Colorado, Georgia ve Maryland) mobil sürücü belgeleri ve kimlikler artık mobil cihazlarda Google Cüzdan gibi dijital cüzdan uygulamalarına sağlanabilir. Belirli online doğrulamalar için dijital kimlik bilgilerinin kabul edilmesiyle ilgili düzenlemeler de ortaya çıkıyor. eIDAS 2.0 buna örnek gösterilebilir.

Dijital kimlik bilgilerinin özellikleri biçimine bağlıdır ancak genellikle şunları içerir:

• Gelişmiş güvenlik ve gizlilik: Gelişmiş şifreleme ve güçlü kimlik doğrulama yöntemlerinin kullanılması, hassas verilerin korunmasına yardımcı olur ve güvenli erişim sağlar. Örneğin, kimlik bilgisinin sunulması genellikle cüzdan uygulaması üzerinden kullanıcı kimlik doğrulaması ile korunur.
• Seçici açıklama: Bağımlı taraflar (RP), kimlik bilgisinden belirli bilgileri isteyebilir. Bu sayede kullanıcılar, paylaşılan verileri kullanım alanı için gerekenlerle sınırlandırabilir. Örneğin, bir kullanıcının 18 yaşından büyük olup olmadığı, doğum tarihi paylaşılmaksızın paylaşılabilir.
• Birlikte çalışabilirlik: Kimlik bilgisi, farklı sistemler ve ülkeler arasında uyumluluğu sağlayarak uluslararası standartlara uygun olmalı ve sınır ötesi kabulü kolaylaştırmalıdır.
• Doğrulanabilirlik: Paylaşılan kimlik bilgisi verileri, veren tarafından dijital olarak imzalanır. RP, verilerin özgünlüğünü doğrulamak için bu imzayı doğrulayabilir.

Dijital kimlik bilgilerinin doğrulanabilir olması, aşağıdaki gibi kullanım alanlarına olanak tanıyabilir:

• Yaş doğrulaması: Yaş kısıtlaması olan içerik yayınlamadan veya yaş kısıtlaması olan öğeler satın almadan önce kullanıcının yaşını doğrulamak için yaş bilgisi isteyin.
• Kimlik doğrulama: Yasal uygunluk veya sahtekarlığı önleme amacıyla bir kişinin kimliğini doğrulamak için ad ve adres isteğinde bulunun.
• Araç kullanma izni kontrolü: Bir kişinin araç kullanmaya uygunluğunu doğrulama (ör. araba kiralarken).

Web siteleri, çeşitli kullanım alanları için dijital kimlik bilgilerini istemek üzere doğrudan mobil cüzdan uygulamalarıyla (ör. özel URL şemaları kullanarak) iletişim kurmaya başladığından tarayıcılar, bu etkileşimi özel bir API aracılığıyla daha güvenli, kötüye kullanıma karşı dayanıklı ve kullanımı daha kolay hale getirme fırsatı görüyor.

Dijital Kimlik Bilgileri API'sinin tanıtımı

Dijital Kimlik Bilgileri API'si, RP web sitelerinin cüzdan uygulamalarından dijital kimlik bilgilerinin sunulmasını istemesine olanak tanıyan yeni bir web platformu API'sidir. API, Chrome 128'den itibaren Chrome'da kaynak denemesi olarak kullanılabilir.

API, protokole bağlı değildir ve RP'nin gereksinimlerine göre bir protokol belirtmesine olanak tanır. Bir RP istek gönderdiğinde tarayıcı, isteği mobil işletim sistemine gönderir. İşletim sistemi, yüklü cüzdan uygulamalarında eşleşen bir kimlik bilgisi arar. Bu tür bir uygulama bulunursa mobil işletim sistemi kullanıcıdan bir uygulama seçmesini ister ve isteği kullanıcının seçtiği cüzdana gönderir. Cüzdan, yerel kimlik doğrulamasından sonra istenen kimlik bilgisi verilerini içeren bir yanıt döndürür.

Chrome, API'yi ilk olarak Android'deki Chrome'da, aynı cihazdaki cüzdan uygulamalarından kimlik bilgileri istemek için destekleyecektir. Gelecekte, Chrome masaüstünde başka bir mobil cihazdan cihazlar arası kimlik bilgileri isteğinde bulunulmasını desteklemeyi planlıyoruz.

Google Cüzdan, kullanıma sunulduğunda Dijital Kimlik Bilgileri API'si ile entegre olacak. Bu sayede belirli işletmeler ve kuruluşlar, Android'deki Chrome üzerinden kullanıcıların kimliklerini online olarak sunmaları için istek başlatabilecek ve şifreleme imzasını inceleyerek aktarılan verilerin gerçekliğini doğrulayabilecek. Programa katılmak için Google Cüzdan'dan dijital kimlikleri kabul etmek istediğinizi belirtmek üzere bu formu doldurun.

API, yakında Google Hesapları tarafından belirli kullanıcıların doğum tarihlerini doğrulamak için de kullanılacak. Desteklenen bir ABD eyaletinde ikamet eden kullanıcılar, mevcut cüzdan uygulamalarında (Google Cüzdan dahil) sağlanan eyalet kimliklerini veya sürücü belgelerini kullanarak kimliklerinin diğer ayrıntılarını paylaşmadan yalnızca doğum tarihlerini Google ile sorunsuz bir şekilde paylaşabilir. Bu sayede kullanıcılar, hesapla ilgili yaş şartlarını gizliliği koruyarak Google'a gösterebilir.

Deneyin

Koşullar:

• Google Play Hizmetleri 23.40 veya sonraki sürümler
• Chrome 128 veya sonraki sürümler
• chrome://flags#web-identity-digital-credentials adresinde işareti etkinleştirin

Dijital Kimlik Bilgileri API'sini denemek için talimatları uygulayın:

1. Talimatları uygulayarak demo cüzdan uygulamasını yükleyin.
   • Android cihazınıza demo cüzdan uygulamasını indirin. Kaynak kodu, OpenWallet Foundation'ın Identity Credentials (Kimlik Kimlik Bilgileri) deposunda bulunabilir.
   • Uygulamayı yüklemek için bir komut adb install -t <path-to-apk> çalıştırın.
2. IC Wallet uygulamasını başlatın ve bir demo mobil sürücü belgesi (mDL) sağlayın.
   • Menü düğmesine dokunup Kendi İmzalı Belge Ekle'yi seçin.
3. Chrome 128 veya sonraki sürümleri kullanarak https://digital-credentials.dev adresine gidin.
4. Kimlik Bilgileri İste (OpenID4VP)'ye basın.

Geliştiricilerin farklı özellikler için kimlik bilgisi istekleri oluşturabileceği bir test web sitesi olan https://digital-credentials.dev adresini kullanan demoya göz atın:

Demo'nun adım adım işleyiş şekli:

API'nin işleyiş şekli

Dijital Kimlik Bilgileri API'si, Kimlik Bilgileri Yönetimi API'si'nin temeli üzerine inşa edilmiş ancak bağımsız bir API yüzeyinden (navigator.identity) oluşturulmuştur. Web sitesi, navigator.identity.get() adresini arayarak mobil cüzdan uygulamasında depolanan dijital kimlik bilgisi isteyebilir.

// Gets a CBOR with specific fields out of mobile driver's license as an mdoc
const controller = new AbortController();
const {protocol, data} = await navigator.identity.get({
  signal: controller.signal,
  digital: {
    providers: [{
      protocol: "openid4vp",
      request: {
        response_type: "vp_token",
        nonce: "n-0S6_WzA2Mj",
        client_metadata: {...},
        presentation_definition: {...}
      }
    }],
  }
});

Temel API yüzeyi, yalnızca "digital" kimlik bilgisi türünü kabul etmesi dışında navigator.credentials.get()'e benzer. Dijital kimlik bilgisi türüne, aşağıdaki temel parametrelerle IdentityRequestProvider içeren bir providers dizisi ekleyin:

• protocol: Bir dizeyle exchange protokolü belirtin. Kaynak denemesi sırasında geliştirilmekte olan birincil protokol "openid4vp"'tür.
• request: Dijital cüzdan uygulamalarının belirtilen protokol için kabul ettiği parametreleri girin. "openid4vp" için parametreler, W3C Dijital Kimlik Bilgileri API'si için Doğrulanabilir Sunum (OID4VP) OpenID spesifikasyonunda tanımlanır.

OID4VP kullanan dijital kimlik türüne örnek yükü:

{
  protocol: 'openid4vp',
  request: {
    response_type: 'vp_token',
    nonce: 'gf69kepV+m5tGxUIsFtLi6pwg=',
    client_metadata: {},
    presentation_definition: {
      id: 'mDL-request-demo',
      input_descriptors: [{
        id: "org.iso.18013.5.1.mDL",
        format: {
          mso_mdoc: {
            alg: ["ES256"]
          }
        },
        constraints: {
          limit_disclosure: "required",
          fields: [
            {
              path: ["$['org.iso.18013.5.1']['family_name']"],
              intent_to_retain: false
            }, {
              path: ["$['org.iso.18013.5.1']['given_name']"],
              intent_to_retain: false
            }, {
              path: ["$['org.iso.18013.5.1']['age_over_21']"],
              intent_to_retain: false
            }
          ]
        }
      }],
    }
  }
}

Bu istekle, cihazda mDL'leri olan cüzdanlar aşağıdakileri içeren doğrulanabilir bir kimlik bilgisi grubu sağlar:

• Kullanıcının soyadı.
• Kullanıcıya verilen ad.
• Kullanıcının 21 yaşından büyük olup olmadığını belirten bir boole değeri.

Aşağıda örnek bir yanıt yükü verilmiştir:

{
  data: '{\n  "vp_token": "o2d2ZXJzaW9uYz..."\n}'
  id: '',
  protocol: 'openid4vp',
  type: 'digital'
}

Bu örnekte, kimlik bilgisi "openid4vp" protokolüyle istenmiştir ve yanıt, data mülkünde "vp_token" içerir. Yanıtı nasıl ayrıştıracağınızı ve kimlik bilgilerini nasıl doğrulayacağınızı öğrenmek için lütfen W3C Dijital Kimlik Bilgileri API'si için Doğrulanabilir Sunma (OID4VP) OpenID spesifikasyonuna bakın.

Digital Credentials API, Android'de Chrome'da kaynak denemesi olarak desteklenir. Masaüstü ve iOS'teki Chrome şu anda bu özelliği desteklemiyor. Diğer tarayıcı motorları için aktif görüşmeler W3C Web Incubator Topluluk Grubu aracılığıyla kolaylaştırılmaktadır.

Kaynak denemesine katılma

Geliştirme için Chrome 128 veya sonraki sürümlerde Chrome işaretçisini chrome://flags#web-identity-digital-credentials etkinleştirerek Dijital Kimlik Bilgileri API'yi yerel olarak etkinleştirebilirsiniz.

Bu özellik, kaynak deneme sürümü olarak da kullanılabilir. Kaynak denemeleri, yeni özellikleri denemenize ve kullanılabilirlikleri, pratiklikleri ve etkililikleri hakkında web standartları topluluğuna geri bildirim vermenize olanak tanır. Daha fazla bilgi için Kaynak denemelerini kullanmaya başlama başlıklı makaleyi inceleyin. Bu veya başka bir kaynak denemesine kaydolmak için kayıt sayfasını ziyaret edin.

1. Kaynağınız için jeton isteyin.
2. Jetonu sayfalarınıza ekleyin. Bunu yapmanın iki yolu vardır:
   • Her sayfanın başına bir origin-trial <meta> etiketi ekleyin. Örneğin, bu şu şekilde görünebilir: <meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">.
   • Sunucunuzu yapılandırabiliyorsanız jetonu Origin-Trial HTTP üst bilgisi kullanarak da ekleyebilirsiniz. Elde edilen yanıt üstbilgisi şöyle görünmelidir:Origin-Trial: TOKEN_GOES_HERE.

Geri bildirim

Digital Credentials API ile ilgili geri bildiriminiz varsa özel Chromium sorun izleyicisine gönderin.