Wygenerowanie zgodnego ze standardem tokenu JWT w formacie JWS Compact Serialization (RFC 7515 sekcja 3.1) przekształca nagłówek JOSE, zestaw atrybutów JSON claims oraz symetryczny klucz tajny w trzyczęściowy ciąg znaków o strukturze <header>.<payload>.<signature>.
1. Skonstruuj nagłówek JOSE i ładunek claims dla API
Zacznij od chronionego nagłówka HS256 oraz ładunku JSON łączącego zarejestrowane atrybuty RFC 7519 (iss, sub, aud, iat, exp) z własnymi atrybutami aplikacji (role):
{
"alg": "HS256",
"typ": "JWT"
}
{
"iss": "https://auth.example.com",
"sub": "usr_9481",
"aud": "api.example.com",
"iat": 1767225600,
"exp": 1767229200,
"role": "admin"
}
W tym przykładzie 1767225600 odpowiada dacie 2026-01-01T00:00:00Z, natomiast 1767229200 oznacza 2026-01-01T01:00:00Z (1-godzinny czas życia tokenu).
2. Zbuduj dane wejściowe do podpisu w Base64URL bez dopełnienia
Każdy obiekt JSON jest minifikowany do bajtów UTF-8 bez zbędnych białych znaków, kodowany w standardzie Base64URL (alfabet ze znakami - oraz _, z usuniętym dopełnieniem =) i łączony kropką ASCII (.):
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJodHRwczovL2F1dGguZXhhbXBsZS5jb20iLCJzdWIiOiJ1c3JfOTQ4MSIsImF1ZCI6ImFwaS5leGFtcGxlLmNvbSIsImlhdCI6MTc2NzIyNTYwMCwiZXhwIjoxNzY3MjI5MjAwLCJyb2xlIjoiYWRtaW4ifQ
3. Powtarzalny wektor testowy podpisywania HMAC-SHA256
Interfejs Web Crypto importuje bajty klucza tajnego za pomocą wywołania crypto.subtle.importKey("raw", secretBytes, { name: "HMAC", hash: "SHA-256" }, false, ["sign"]) i podpisuje dokładne bajty ASCII ciągu <base64url-header>.<base64url-payload>. Deterministyczną zgodność między OpenSSL, modułem crypto w Node.js, biblioteką PyJWT w Pythonie oraz tym generatorem możesz zweryfikować przy użyciu kanonicznego wektora testowego HS256 z sekretem UTF-8 your-256-bit-secret:
{
"sub": "1234567890",
"name": "John Doe",
"iat": 1516239022
}
Podpisanie nagłówka {"alg":"HS256","typ":"JWT"} oraz powyższego ładunku kluczem your-256-bit-secret zawsze daje ten sam 147-znakowy token, gotowy do użycia w nagłówku HTTP Authorization: Bearer <token> lub do weryfikacji zwrotnej w narzędziu Dekoder i Inspektor JWT:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c