SD-JWT nedir?

SD-JWT (Selective Disclosure for JSON Web Tokens), bazı beyanların gizlendiği imzalı bir token'dır. İhraç eden, bu beyanların yalnızca özet adı verilen tuzlanmış hash değerlerini imzalar. Ardından token sahibi, açıklamalarını token ile birlikte göndererek hangi beyanları açığa çıkaracağına karar verir. Doğrulayıcı, sahibin seçtiği beyanları görür, her birinin ihraç edenin imzaladığı bir özetle eşleştiğini kontrol edebilir ve geri kalanlar hakkında hiçbir şey öğrenmez.

SD-JWT VC, doğrulanabilir kimlik bilgilerini SD-JWT'nin üzerine kurar: bir vct türü kimlik bilgisinin çeşidini belirtir, bir cnf anahtarı ise kimlik bilgisini sahibin cihazına bağlar. SD-JWT VC, her AB ülkesinin Aralık 2026'ya kadar vatandaşlarına sunması gereken AB Dijital Kimlik Cüzdanlarının iki kimlik bilgisi biçiminden biridir; OpenID for Verifiable Credentials da onu kullanır.

SD-JWT neye benzer?

SD-JWT, tilde işaretleriyle (~) ayrılmış parçalardan oluşan bir dizedir:

  • İhraç edenin imzaladığı JWT, header.payload.signature.
  • Açığa çıkarılan her beyan için bir açıklama; her biri rastgele bir salt değeri, beyan adı ve değerinden oluşan, Base64url ile kodlanmış bir JSON dizisidir. Dizi öğelerinin açıklamalarında ad yer almaz.
  • Sonda, sahibin sunumun kendisine ait olduğunu ve bu doğrulayıcıya yönelik olduğunu göstermek için imzaladığı isteğe bağlı bir anahtar bağlama JWT'si. Bu JWT yoksa dize bir tilde ile biter.

Nasıl kullanılır?

SD-JWT'yi yapıştırın. Satır sonları ve boşluklar yok sayılır; bu nedenle bir log'dan kopyalanan, satırlara bölünmüş bir token da çalışır.

İhraç edenin imzasını kontrol etmek için ihraç edenin açık anahtarını JWK, JWK kümesi (token'ın kid değerine sahip anahtar kullanılır), PEM açık anahtarı veya X.509 sertifikası olarak girin. Yapıştırılan özel bir JWK de çalışır; yalnızca açık kısmı kullanılır. Anahtar alanı boşsa ve token başlığında x5c içinde bir sertifika varsa o sertifika kullanılır.

Neler görürsünüz?

  • Kontroller: imza, açıklamalar, anahtar bağlama, geçerlilik süresi ve özet algoritması.
  • Başlık: ihraç edenin JWT'sinin başlığı; algoritması, türü (SD-JWT VC için dc+sd-jwt) ve anahtar kimliğiyle birlikte.
  • İmzalandığı haliyle yük: gizli beyanların özetlerini (_sd) ve gizli dizi öğeleri için {"...": digest} yer tutucularını içerir.
  • Açıklamalarla birlikte beyanlar: her açıklamanın yerine yerleştirildiği, bir doğrulayıcının okuyacağı hâliyle yük.
  • Açıklamalar: her açıklamanın beyanını, değerini, beyanlar içinde nereye yerleştiğini ve özetini gösteren bir tablo.
  • Anahtar bağlama JWT'si: hedef kitle (aud), nonce ve sd_hash ile birlikte başlığı ve yükü.

Kontroller ne anlama gelir?

  • İmza: ihraç edenin JWT'si girdiğiniz anahtarla imzalanmıştır. Araç başlıktaki sertifikaya başvurduğunda, token'ın kendi sertifikasıyla eşleştiğini gösterir. Bu sertifikanın güvenilir bir ihraç edene, örneğin AB'nin güvenilir listelerindeki birine ait olup olmadığı bu kontrolün kapsamı dışındadır.
  • Açıklamalar: her açıklamanın özeti imzalı token'da tam olarak bir kez yer alır. Değiştirilmiş bir açıklamanın özeti farklıdır, bu nedenle artık eşleşmez; iki kez gönderilen bir açıklama da işaretlenir.
  • Anahtar bağlama: anahtar bağlama JWT'sinin sd_hash değeri tam olarak bu sunumun (son tildeye kadar olan SD-JWT) hash değeridir ve onu kimlik bilgisinin cnf alanındaki anahtar imzalamıştır. Bir açıklamayı çıkarmak veya eklemek hash değerini bozar.
  • Geçerlilik süresi: token'ın son kullanma (exp) ve başlangıç (nbf) zamanları cihazınızın saatiyle karşılaştırılır.
  • Özet algoritması: özetler _sd_alg içindeki algoritmayı, token bir algoritma belirtmiyorsa SHA-256'yı kullanır. Tarayıcılar SHA-256, SHA-384 ve SHA-512 hesaplayabilir.

Gizlilik

Kod çözme ve tüm kontroller tarayıcınızda çalışır; bu nedenle token ve anahtarlar hiçbir yere gönderilmez. Gerçek kimlik bilgileri kişisel veriler içerir; bu yüzden ekran görüntüsü paylaşırken test kimlik bilgileri kullanın.