{"canonical_url":"https://engineer.company/uk/glossary/jwt/","content_markdown":"# JWT\n\n## Що це таке\n\nJWT — це короткий рядок, який переносить набір тверджень від однієї сторони до\nіншої в такому вигляді, що одержувач може їх перевірити. Абревіатура\nрозшифровується як JSON Web Token. Формат визначено в RFC 7519 у травні 2015\nроку як компактний спосіб подати твердження (claims), який можна без змін\nпередати в URL, а назву там пропонують вимовляти як англійське слово «jot».\nТвердження — це назва і значення, які стверджують про суб'єкт:\n`\"sub\": \"24400320\"` каже, про кого токен, а `\"exp\": 1300819380` — коли він\nперестає бути чинним.\n\nПід час передавання JWT — це кілька рядків base64url, з'єднаних крапками.\nПідписаний JWT має три частини: заголовок, що називає алгоритм, корисне\nнавантаження (payload) із твердженнями і підпис, обчислений над першими двома.\nЗашифрований має п'ять частин, і його твердження неможливо прочитати без ключа.\nСам RFC 7519 криптографією не займається. Підписування або захист кодом\nавтентифікації повідомлення (MAC) він покладає на JSON Web Signature (RFC\n7515), а шифрування — на JSON Web Encryption (RFC 7516). Алгоритми перелічено в\nRFC 7518, а ключі можна публікувати у форматі JSON Web Key з RFC 7517.\n\n`HS256` — це HMAC із SHA-256: один спільний секрет і створює токен, і перевіряє\nйого, тож кожен сервіс, здатний його перевірити, може й випустити власний.\n`RS256` і `ES256` використовують пару ключів: видавець підписує закритим\nключем, а всі інші перевіряють відкритим, який можна вільно роздавати. RFC 7519\nвимагає реалізувати лише `HS256` і непідписаний `none`, а `RS256` і `ES256`\nрекомендує.\n\nРозділ 4.1 реєструє сім назв тверджень: `iss` (видавець), `sub` (суб'єкт),\n`aud` (аудиторія, тобто одержувач), `exp` (час завершення дії), `nbf` (не\nраніше ніж), `iat` (час видачі) і `jti` (унікальний ідентифікатор, за яким\nможна не допустити повторного використання токена). Назви мають по три літери,\nбо формат задумано компактним, і всі вони необов'язкові. Які твердження має\nмістити токен, вирішує застосунок, що його використовує. Крім зареєстрованих,\nбудь-хто може визначати публічні твердження, зареєстровані в IANA або з назвою,\nщо не може конфліктувати з чужими (наприклад, URL), а також приватні, про які\nдомовилися дві сторони.\n\n## Чому це важливо\n\nСуть JWT у тому, що одержувач може перевірити його сам. Маючи ключ видавця і\nгодинник, сервіс визначає, чи токен справжній, для кого він і чи ще чинний, без\nзапиту до бази даних і без звертання до видавця. RFC 9068 (жовтень 2021 року)\nконстатує, що багато комерційних реалізацій OAuth видають токени доступу, які\nсервери ресурсів розбирають і перевіряють самостійно, що такий підхід особливо\nпоширений там, де сервер, який видає токени, і сервер, який їх приймає,\nрозділені певною межею, і що багато з цих реалізацій використовують JWT. Далі\nцей RFC стандартизує структуру таких токенів, щоб вони працювали в рішеннях\nрізних виробників.\n\nJWT — це також формат, на якому побудовано OpenID Connect: кожен ID-токен є JWT,\nадресованим застосунку, який його запросив. Постачальник ідентичності має\nпідписати його, за винятком випадку, коли одночасно виконано обидві умови\nвикористання `alg` зі значенням `none`: тип відповіді не повертає ID-токена з\nAuthorization Endpoint, як у Authorization Code Flow, і клієнт під час\nреєстрації явно запросив `none`. Коли 2015 року реєстрували медіатип\n`application/jwt`, у реєстрації серед користувачів уже значилися OpenID Connect,\nSalesforce, Google, Android, Windows Azure та Amazon Web Services.\n\nRFC 7519 розраховує формат на місця з обмеженим простором, як-от HTTP-заголовок\nAuthorization і параметри запиту в URI. Тому назви тверджень короткі, а\nкодування використовує лише символи, які проходять в URL без екранування.\n\nТа сама властивість, що робить JWT дешевим у перевірці, ускладнює його\nвідкликання. Одержувач, який перевіряє підпис і час, прийматиме токен до `exp`,\nхоч би що сталося з обліковим записом за цей час.\n\n## Як це виглядає на практиці\n\nRFC 7519 розбирає повний приклад. Заголовок оголошує, що об'єкт є JWT і що його\nзахищено HMAC SHA-256:\n\n```text\n{\"typ\":\"JWT\",\n \"alg\":\"HS256\"}\n```\n\nТвердження називають видавця, час завершення дії та одне публічне твердження,\nназва якого є URL, щоб воно не конфліктувало з твердженнями, які визначає\nхтось інший:\n\n```text\n{\"iss\":\"joe\",\n \"exp\":1300819380,\n \"http://example.com/is_root\":true}\n```\n\nКожну частину кодують у base64url, HMAC обчислюють над заголовком і корисним\nнавантаженням, з'єднаними крапкою, а три результати з'єднують в один рядок. RFC\nнаводить його з розривами рядків, доданими лише для зручності читання:\n\n```text\neyJ0eXAiOiJKV1QiLA0KICJhbGciOiJIUzI1NiJ9\n.\neyJpc3MiOiJqb2UiLA0KICJleHAiOjEzMDA4MTkzODAsDQogImh0dHA6Ly9leGFt\ncGxlLmNvbS9pc19yb290Ijp0cnVlfQ\n.\ndBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk\n```\n\nЗ цього прикладу випливають три речі. По-перше, твердження може прочитати\nкожен, у кого є токен: base64url — це кодування, тож середня частина після\nдекодування знову стає JSON, і ключ для цього не потрібен. По-друге, підпис\nохоплює закодовані рядки точно в тому вигляді, у якому їх надіслано. Заголовок\nу RFC містить розрив рядка CRLF і пробіл на початку другого рядка, і RFC\nнаводить точні байти, щоб уникнути неоднозначності. Якщо охайніше\nвідформатувати JSON і закодувати його знову, вийде інший рядок, і підпис\nперестане сходитися. Ключ для цього прикладу наведено в додатку A.1 до RFC\n7515, і з ним підпис успішно перевіряється. По-третє, строк дії токена давно\nминув: `1300819380` секунд після 1 січня 1970 року — це 22 березня 2011 року,\n18:43 UTC, тож коректний валідатор сьогодні його відхилить.\n\nОдержувач, який отримав такий токен, виконує фіксований набір перевірок, перш\nніж прочитати бодай одне твердження. Він розділяє рядок за крапками, декодує\nзаголовок і переконується, що це коректний JSON, у якому лише ті параметри й\nзначення, синтаксис і зміст яких він розуміє та підтримує, або які прямо\nвизначено як такі, що їх слід ігнорувати, якщо вони невідомі. Він порівнює `alg`\nз алгоритмами, які вирішив приймати саме для цього видавця і ключа: RFC 7519\nпрямо каже, що це рішення застосунку і що токен слід відхилити, якщо алгоритм\nнеприйнятний, навіть коли підпис дійсний. Він перевіряє підпис ключем, який\nналежить видавцеві. Потім перевіряє твердження: `iss` має бути видавцем, якому\nвін довіряє, `aud` має називати самого одержувача, поточний час має бути раніше\nза `exp` (із запасом щонайбільше кілька хвилин на розбіжність годинників) і\nпізніше за `nbf`, якщо таке твердження є. Лише після цього він діє на підставі\nтверджень.\n\nТокен доступу у форматі JWT за RFC 9068 показує, що додає конкретний профіль.\nЙого заголовок у цьому RFC такий:\n`{\"typ\":\"at+JWT\",\"alg\":\"RS256\",\"kid\":\"RjEwOwOA\"}`, тобто явний тип, асиметричний\nалгоритм та ідентифікатор ключа в опублікованому наборі ключів видавця. Профіль\nробить обов'язковими `iss`, `exp`, `aud`, `sub`, `client_id`, `iat` і `jti`, а\nсервер ресурсів має перевірити, що `typ` дорівнює `at+jwt` або\n`application/at+jwt`, і відхилити інші типи. Ці назви медіатипів і підтипів\nнечутливі до регістру; `at+JWT` у прикладі — рівнозначний запис.\n\nТвердження в токені — це знімок стану на момент підписання, тож усе, що може\nзмінитися до `exp`, краще вирішувати на сервері. В одному з проєктів цього\nсайту,\n[посиленні захисту застосунку на кожному рівні](/uk/portfolio/hardened-the-application-with-nonce-based-csp/),\nсервер повторно перевіряє права доступу (тариф, роль, організацію, прив'язку до\nсудна) під час кожного запиту, а обмеження на фронтенді вважаються суто\nпитанням UX.\n\n## Де виникають проблеми\n\n**Токен сам обирає свій алгоритм.** Заголовок `alg` існує заради гнучкості, і\nRFC 8725 описує, як деякі бібліотеки надто йому довіряли. Зловмисник міг\nзмінити його на `none`, і бібліотека приймала токен зовсім без підпису. Або\nзмінити `RS256` на `HS256`, і бібліотека перевіряла HMAC, використовуючи\nвідкритий ключ RSA видавця як спільний секрет, хоча цей ключ зловмисник може\nпросто завантажити. Налаштуйте бібліотеку на алгоритми, які ви приймаєте,\nвикористовуйте кожен ключ рівно з одним алгоритмом і відхиляйте `none` без\nвинятків.\n\n**Секрет HMAC — це пароль.** Токен, підписаний `HS256` коротким секретом, який\nлегко запам'ятати, можна атакувати офлайн: той, у кого є хоч один токен, може\nперебирати варіанти у власному темпі, не звертаючись до вашого сервера. RFC\n8725 забороняє використовувати пароль, який людина здатна запам'ятати,\nбезпосередньо як ключ HMAC, а RFC 7518 вимагає для `HS256` ключа завдовжки\nщонайменше 256 біт. Генеруйте ключ криптографічно стійким генератором\nвипадкових чисел, зберігайте його у сховищі секретів і обирайте пару ключів,\nколи багатьом сервісам потрібно лише перевіряти.\n\n**Підпис правильний, тож усьому іншому вірять.** Дійсний підпис доводить, хто\nвидав токен, але не те, для кого його призначено. Якщо один видавець обслуговує\nкілька сервісів, а одержувач пропускає перевірку `aud`, токен, законно\nнадісланий одному сервісу, можна повторно використати проти іншого. RFC 8725\nназиває це підміною і вимагає, щоб одержувачі таких токенів перевіряли\nаудиторію та відхиляли токен без неї. Звіряйте `aud` із власним\nідентифікатором і перевіряйте, що ключ підпису належить видавцеві, зазначеному\nв `iss`.\n\n**Один вид токена видають за інший.** ID-токен, токен доступу і токен події\nбезпеки (security event token) від того самого видавця можуть бути дуже\nсхожими, і одержувач, який перевіряє лише підпис і видавця, може прийняти не\nтой вид. RFC 8725 називає це плутаниною між різними JWT (cross-JWT confusion) і\nрекомендує явно зазначати тип у заголовку `typ`; RFC 9068 застосовує це через\n`at+jwt`. Дайте кожному виду токенів власний тип або аудиторію і пишіть правила\nперевірки так, щоб кожен вид відсіювали перевірки, призначені для інших.\n\n**Ключ обирає заголовок.** Заголовок `kid` вказує, яким ключем скористатися, а\n`jku` і `x5u` можуть указувати на URL, звідки ключ завантажити. Усі вони\nнадходять від відправника. `kid`, переданий без перевірки в запит до бази даних\nабо в пошук у файловому каталозі, стає шляхом усередину цієї системи, а сервер,\nякий іде за будь-якою URL-адресою з `jku` чи `x5u`, можна змусити надсилати\nзапити куди завгодно. Шукайте `kid` лише серед ключів, які у вас уже є, і\nзавантажуйте ключі тільки з дозволеного переліку адрес, наприклад з\nопублікованого видавцем `jwks_uri`.\n\n**Корисне навантаження може прочитати будь-хто.** Підписаний JWT захищає свої\nтвердження від змін, але не від читання, а проходить він часто через браузери,\nжурнали і проксі. RFC 7519 зазначає, що JWT може містити дані, чутливі з\nпогляду приватності, і що найпростіший захист — не додавати їх. Інакше токен\nслід шифрувати або принаймні передавати лише через TLS. RFC 9068 додає, що\nклієнт узагалі не повинен зазирати в токен доступу, бо видавець може будь-коли\nзмінити його формат. Кладіть у токен ідентифікатори, а не персональні дані, і\nшифруйте, коли сам вміст має лишатися приватним.\n\n## Що почитати далі\n\n- [RFC 7519: JSON Web Token (JWT)](https://www.rfc-editor.org/rfc/rfc7519) —\n  сам формат: зареєстровані твердження, розібраний приклад і кроки перевірки.\n- [RFC 7515: JSON Web Signature (JWS)](https://www.rfc-editor.org/rfc/rfc7515) —\n  як кодують і з'єднують заголовок, корисне навантаження та підпис, а також\n  ключ до прикладу вище.\n- [RFC 8725: JSON Web Token Best Current Practices](https://www.rfc-editor.org/rfc/rfc8725)\n  — відомі атаки на JWT і правила для бібліотек і застосунків, які їм\n  запобігають.\n- [RFC 7518: JSON Web Algorithms (JWA)](https://www.rfc-editor.org/rfc/rfc7518)\n  — назви алгоритмів для `alg` і мінімальний розмір ключа для кожного HMAC.\n- [RFC 9068: JWT Profile for OAuth 2.0 Access Tokens](https://www.rfc-editor.org/rfc/rfc9068)\n  — стандартна структура токенів доступу у форматі JWT і перевірки, які має\n  виконати сервер ресурсів.\n\n\u003chttps://engineer.company/uk/glossary/jwt/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як JWT переносить підписані твердження у трьох частинах через крапку, що має перевірити сервер, перш ніж йому повірити, і шість типових помилок.","formats":{"gemtext":"https://engineer.company/uk/glossary/jwt/index.gmi","gopher":"https://engineer.company/uk/glossary/jwt/gophermap","html":"https://engineer.company/uk/glossary/jwt/","json":"https://engineer.company/uk/glossary/jwt/index.json","markdown":"https://engineer.company/uk/glossary/jwt/index.md","pdf":"https://engineer.company/uk/glossary/jwt/index.pdf"},"kind":"page","language":"uk","title":"Що таке JWT?","url":"https://engineer.company/uk/glossary/jwt/","version":1}