Token JSON Web Token zgodny ze standardem RFC 7519 przesyłany w postaci JWS Compact Serialization składa się z trzech ciągów Base64URL bez znaków dopełnienia, połączonych kropkami: <header>.<payload>.<signature>. Jeśli skopiujesz wartość nagłówka HTTP, na przykład Authorization: Bearer <token>, dekoder automatycznie usunie początkowy prefiks schematu Bearer przed podzieleniem ciągu według znaku ..
Przeanalizujmy ten standardowy, kompaktowy token podpisany algorytmem HS256:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
1. Odkodowany chroniony nagłówek JOSE (Protected Header)
Odkodowanie pierwszego segmentu Base64URL (eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9) daje 27 bajtów UTF-8 opisujących algorytm kryptograficzny oraz typ mediów:
{
"alg": "HS256",
"typ": "JWT"
}
2. Odkodowany ładunek deklaracji (Claims Payload) i znaczniki czasu NumericDate
Odkodowanie drugiego segmentu Base64URL (eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ) ujawnia obiekt JSON zawierający zestaw deklaracji (claims):
{
"sub": "1234567890",
"name": "John Doe",
"iat": 1516239022
}
W tym przypadku pole iat (1516239022) odpowiada dacie 2018-01-18T01:30:22Z w strefie UTC. Podczas inspekcji produkcyjnego tokenu dostępu zawierającego pełne ramy czasowe cyklu życia, inspektor porównuje każdą deklarację NumericDate z bieżącym zegarem systemowym:
{
"iss": "https://auth.example.com",
"sub": "usr_9481",
"iat": 1735689600,
"nbf": 1735689600,
"exp": 1735693200
}
iat(1735689600): Wydano o2025-01-01T00:00:00Z.nbf(1735689600): Nieważny przed2025-01-01T00:00:00Z.exp(1735693200): Wygasa o2025-01-01T01:00:00Z(dokładny czas życia TTL wynoszący 3600 sekund).
3. Lokalna weryfikacja podpisu HMAC-SHA256
Samo odkodowanie dowodzi jedynie, że pierwsze dwa segmenty są poprawnym kodem JSON zakodowanym w Base64URL; nie stanowi natomiast dowodu na to, że deklaracje nie zostały zmodyfikowane. Gdy podasz klucz tajny your-256-bit-secret dla pierwszego przykładu powyżej, weryfikator przekazuje dokładny wejściowy ciąg ASCII do podpisu (eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ) oraz 43-znakowy podpis Base64URL (SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c) do funkcji crypto.subtle.verify("HMAC", key, signatureBytes, signingInputBytes). Zmiana choćby jednego bitu w odkodowanym ładunku JSON zmienia oczekiwany 32-bajtowy znacznik MAC i natychmiast powoduje błąd niezgodności podpisu.