Генерація сумісного зі стандартами JWT у компактному форматі JWS Compact Serialization (RFC 7515, розділ 3.1) перетворює заголовок JOSE, набір тверджень JSON (claims) і симетричний секретний ключ на тричастинний рядок вигляду <header>.<payload>.<signature>.
1. Формування заголовка JOSE та корисного навантаження API
Почнемо із захищеного заголовка HS256 та JSON-навантаження, яке поєднує зареєстровані в RFC 7519 поля (iss, sub, aud, iat, exp) із власними полями застосунку (role):
{
"alg": "HS256",
"typ": "JWT"
}
{
"iss": "https://auth.example.com",
"sub": "usr_9481",
"aud": "api.example.com",
"iat": 1767225600,
"exp": 1767229200,
"role": "admin"
}
Тут 1767225600 відповідає 2026-01-01T00:00:00Z, а 1767229200 — 2026-01-01T01:00:00Z (час життя токена — 1 година).
2. Побудова вхідного рядка для підпису в Base64URL без доповнення
Кожен JSON-об'єкт мініфікується у байти UTF-8 без зайвих пробілів, кодується в Base64URL (алфавіт із - та _, символи вирівнювання = видаляються) і з'єднується крапкою ASCII (.):
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJodHRwczovL2F1dGguZXhhbXBsZS5jb20iLCJzdWIiOiJ1c3JfOTQ4MSIsImF1ZCI6ImFwaS5leGFtcGxlLmNvbSIsImlhdCI6MTc2NzIyNTYwMCwiZXhwIjoxNzY3MjI5MjAwLCJyb2xlIjoiYWRtaW4ifQ
3. Відтворюваний тестовий вектор підпису HMAC-SHA256
Web Crypto імпортує байти вашого секрету через crypto.subtle.importKey("raw", secretBytes, { name: "HMAC", hash: "SHA-256" }, false, ["sign"]) і підписує точні байти ASCII рядка <base64url-header>.<base64url-payload>. Ви можете перевірити детермінований збіг результатів між OpenSSL, модулем crypto у Node.js, бібліотекою PyJWT у Python та цим генератором, використовуючи канонічний тестовий вектор HS256 із UTF-8 секретом your-256-bit-secret:
{
"sub": "1234567890",
"name": "John Doe",
"iat": 1516239022
}
Підписання заголовка {"alg":"HS256","typ":"JWT"} і наведеного вище навантаження ключем your-256-bit-secret завжди дає цей точний 147-символьний токен, готовий для передавання в HTTP-заголовку Authorization: Bearer <token> або для зворотної перевірки у Декодері та інспекторі JWT:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c