Czym jest SD-JWT?

SD-JWT (Selective Disclosure for JSON Web Tokens) to podpisany token, w którym niektóre atrybuty są ukryte. Wystawca podpisuje jedynie skróty tych atrybutów obliczone z dodatkiem soli. Posiadacz decyduje następnie, które atrybuty ujawnić, przesyłając wraz z tokenem odpowiadające im ujawnienia. Weryfikator widzi atrybuty wybrane przez posiadacza, może sprawdzić, czy każdy z nich odpowiada skrótowi podpisanemu przez wystawcę, i nie dowiaduje się niczego o pozostałych.

SD-JWT VC buduje na tej podstawie weryfikowalne poświadczenia: typ vct określa rodzaj poświadczenia, a klucz cnf wiąże poświadczenie z urządzeniem posiadacza. To jeden z dwóch formatów poświadczeń w europejskich portfelach tożsamości cyfrowej, które każdy kraj UE musi udostępnić obywatelom do grudnia 2026 roku; korzysta z niego także OpenID for Verifiable Credentials.

Jak wygląda SD-JWT

SD-JWT to ciąg części oddzielonych tyldami (~):

  • JWT podpisany przez wystawcę, header.payload.signature.
  • Jedno ujawnienie na każdy ujawniony atrybut; każde z nich to tablica JSON zakodowana w Base64url, zawierająca losową sól, nazwę atrybutu i jego wartość. Ujawnienia elementów tablic nie zawierają nazwy.
  • Opcjonalny JWT powiązania klucza na końcu, który posiadacz podpisuje, aby wykazać, że prezentacja należy do niego i jest przeznaczona dla danego weryfikatora. Bez niego ciąg kończy się tyldą.

Jak z niego korzystać

Wklej SD-JWT. Podziały wierszy i spacje są ignorowane, więc zadziała też zawinięty token skopiowany z logu.

Aby sprawdzić podpis wystawcy, wprowadź jego klucz publiczny jako JWK, zestaw JWK (używany jest klucz o identyfikatorze kid z tokenu), klucz publiczny PEM lub certyfikat X.509. Wklejony prywatny JWK również zadziała; używana jest tylko jego część publiczna. Gdy pole klucza jest puste, używany jest certyfikat z pola x5c w nagłówku tokenu, o ile występuje.

Co zobaczysz

  • Weryfikacje podpisu, ujawnień, powiązania klucza, okresu ważności i algorytmu skrótu.
  • Nagłówek JWT wystawcy z algorytmem, typem (dc+sd-jwt w przypadku SD-JWT VC) i identyfikatorem klucza.
  • Dane w postaci podpisanej ze skrótami (_sd) ukrytych atrybutów i symbolami zastępczymi {"...": digest} w miejscu ukrytych elementów tablic.
  • Atrybuty z ujawnieniami, czyli dane z każdym ujawnieniem wstawionym we właściwe miejsce, tak jak odczytałby je weryfikator.
  • Ujawnienia, czyli tabela z atrybutem, wartością, miejscem wśród atrybutów i skrótem każdego ujawnienia.
  • JWT powiązania klucza, czyli jego nagłówek i dane z odbiorcą (aud), wartością nonce i sd_hash.

Co oznaczają weryfikacje

  • Podpis: JWT wystawcy jest podpisany wprowadzonym kluczem. Gdy narzędzie korzysta zastępczo z certyfikatu z nagłówka, pokazuje, że token pasuje do własnego certyfikatu. To, czy certyfikat należy do zaufanego wystawcy, np. znajdującego się na zaufanych listach UE, wykracza poza zakres tej weryfikacji.
  • Ujawnienia: skrót każdego ujawnienia występuje w podpisanym tokenie dokładnie raz. Zmienione ujawnienie ma inny skrót, więc przestaje pasować, a ujawnienie wysłane dwukrotnie zostaje oznaczone.
  • Powiązanie klucza: sd_hash w JWT powiązania klucza jest skrótem dokładnie tej prezentacji (SD-JWT do ostatniej tyldy), a JWT został podpisany kluczem z pola cnf poświadczenia. Usunięcie lub dodanie ujawnienia powoduje niezgodność skrótu.
  • Okres ważności: czas wygaśnięcia (exp) i rozpoczęcia ważności (nbf) tokenu w porównaniu z zegarem Twojego urządzenia.
  • Algorytm skrótu: skróty są obliczane algorytmem podanym w _sd_alg lub algorytmem SHA-256, jeśli token go nie określa. Przeglądarki potrafią obliczać SHA-256, SHA-384 i SHA-512.

Prywatność

Dekodowanie i wszystkie weryfikacje odbywają się w przeglądarce, więc token i klucze nie są nigdzie wysyłane. Prawdziwe poświadczenia zawierają dane osobowe, dlatego udostępniając zrzuty ekranu, korzystaj z poświadczeń testowych.