Dekoder SD-JWT
Dekoduj poświadczenie SD-JWT lub SD-JWT VC: sprawdź nagłówek, zestaw twierdzeń z uzupełnionymi wszystkimi ujawnieniami, hash każdego ujawnienia oraz JWT wiążący klucz, a także zweryfikuj podpis wystawcy. Działa w przeglądarce.
Wejście
Wyjście
| Atrybut | Wartość | Skrót |
|---|---|---|
| Brak ujawnień | ||
Instrukcja
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-jwtw 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ąnonceisd_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_hashw JWT powiązania klucza jest skrótem dokładnie tej prezentacji (SD-JWT do ostatniej tyldy), a JWT został podpisany kluczem z polacnfpoś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_alglub 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.