JWT (JSON Web Token), iki taraf arasında güvenli bir şekilde bilgi alışverişi yapmak için kullanılan, JSON formatında bir token'dır. Genellikle kimlik doğrulama ve yetkilendirme işlemlerinde kullanılır. JWT, kullanıcı oturumlarını yönetmek, API'lere erişim sağlamak ve veri bütünlüğünü korumak gibi amaçlarla kullanılır.
JWT — открытый стандарт, определённый в RFC 7519, который передаёт данные о пользователе и сессии между клиентом и сервером внутри подписанного компактного токена. Статья описывает части JWT, этапы работы от входа в систему до проверки и правила безопасного использования.
Nurullah Okatan · Автор контента
· Обновлено: · 2 мин чтения

JWT (JSON Web Token) — открытый стандарт, который передаёт данные о пользователе и сессии внутри подписанной компактной строки. Сервер выдаёт этот токен вошедшему пользователю и при каждом следующем запросе проверяет подпись, поэтому узнаёт пользователя без обращения к базе данных.
Что такое JWT и какую проблему он решает?
JWT — формат токена, разработанный IETF и описанный в документе RFC 7519. Источник Kodedu тоже ссылается на стандарт по этому номеру документа. По словам Descope, цель — создавать компактные и самодостаточные токены, которые передают информацию между приложениями или сервисами. Самодостаточность означает, что данные, необходимые для проверки, находятся внутри самого токена.

Каждая единица информации внутри токена называется claim (утверждение). По определению из Википедии, полезная нагрузка JWT — это JSON-данные, содержащие набор утверждений. Например, "sub" указывает идентификатор пользователя, "exp" — время окончания действия токена, "iss" — систему, выпустившую токен. Приложение может добавлять и собственные поля, например роль пользователя.
JWT чаще всего используется для аутентификации. Пользователь входит в систему один раз, а в следующих запросах предъявляет токен. Это распространено в структурах, где мобильное приложение общается с сервером или одностраничное веб-приложение обращается к бэкенду. Также он часто встречается в микросервисных архитектурах, где сервисы обращаются друг к другу. Почти все такие запросы идут через API. Если тема новая, статья о том, что такое API и как он работает объясняет эту структуру шаг за шагом.
ИИ-помощник по этой теме
ИИ Türk Bilişim мгновенно отвечает на ваши вопросы- Здравствуйте! Спрашивайте о чём угодно.
Три части JWT: header, payload и signature
По данным Monofor, JWT состоит из трёх частей в кодировке Base64URL, соединённых точками: header.payload.signature. Определение Postman описывает ту же структуру. Каждая из трёх частей — закодированная строка, а между ними стоит точка.
| Часть | Что содержит | Примеры полей |
|---|---|---|
| Header (заголовок) | Тип токена и алгоритм подписи | "alg" (название алгоритма), "typ": "JWT" |
| Payload (полезная нагрузка) | Утверждения о пользователе и сессии | "sub", "exp", "iat", "role" |
| Signature (подпись) | Хэш header и payload, подписанный секретным ключом | Base64URL-представление байтов, которые вычислил алгоритм |
Base64URL — это кодирование, а не шифрование. Закодированный текст может любой декодировать обратно в обычный JSON несколькими строками кода или онлайн-декодером. Monofor прямо отмечает: стандартный JWT подписан, но не зашифрован, поэтому любой, кто получит токен, может прочитать его содержимое.
Токен защищает подпись. По данным SuperTokens, каждый JWT цифровым образом подписывается, чтобы его нельзя было изменить. Сервер заново подписывает часть header и payload входящего токена своим ключом. Согласно правилу, описанному Kodedu, если вычисленная подпись совпадает с третьей частью, токен считается подлинным. Если не совпадает — токен недействителен.
Если злоумышленник заменит в payload значение "role" с "user" на "admin", подпись перестанет совпадать. Без ключа он также не сможет создать новую действительную подпись.
Нужна услуга «Лендинг для конверсии»?Этапы работы JWT от входа в систему до проверки запроса
Поток JWT начинается с запроса на вход и продолжается проверкой при каждом защищённом запросе. По данным Postman, когда пользователь входит в приложение, сервер создаёт JWT и отправляет его клиенту.
- Пользователь вводит e-mail и пароль, клиент отправляет их на сервер.
- Сервер проверяет данные в базе и, если они верны, формирует утверждения.
- Сервер подписывает header и payload своим ключом и возвращает токен клиенту.
- Клиент сохраняет токен и при каждом запросе отправляет его в заголовке "Authorization: Bearer <token>".
- Сервер заново вычисляет подпись и проверяет срок действия по полю "exp".
- Если подпись совпадает и срок не истёк, запрос обрабатывается, иначе сервер отклоняет его ответом "Не авторизован".
На пятом этапе база данных не запрашивается. Проверка подписи выполняется только с помощью ключа и данных из токена. По данным SuperTokens, JWT позволяет проверять подлинность локально, без запроса к базе данных, и благодаря этому возможна stateless-аутентификация. На сервисе, обрабатывающем тысячи запросов в секунду, для каждого запроса не нужно обращаться к таблице сессий. Каждый сервер за балансировщиком нагрузки может проверить токен самостоятельно, если знает тот же ключ.
Добавление этого потока в существующую систему запланировано как часть проектирования API. Türk Bilişim, крупнейшая в Турции компания по чат-ботам с ИИ и ассистентам для клиентов, в рамках услуги Разработка API и интеграция создаёт связи между сервисами с такими слоями аутентификации. Компания работает как цифровое агентство с 1998 года и занимается разработкой решений на основе искусственного интеллекта с 2022 года. Похожие архитектурные вопросы рассматриваются и в статьях о разработке индивидуального программного обеспечения.
Различия между JWT и сессией на основе cookie
При сессии на основе cookie данные о пользователе хранятся на сервере. Браузер передаёт только случайный идентификатор сессии. В JWT же данные находятся внутри самого токена, и сервер не ведёт записей. О том, как работают cookie в браузере, подробно рассказано в статье о cookie.

| Критерий | Сессия на основе cookie | JWT |
|---|---|---|
| Где хранятся данные | Хранилище сессий на сервере | Внутри payload токена |
| Проверка | Запрос к хранилищу при каждом обращении | Проверка подписи, без запроса |
| Немедленная отмена | Достаточно удалить запись | Нужен дополнительный список отзыва |
| Подходящая структура | Классический сайт на одном сервере | Мобильное приложение, API, многосервисная архитектура |
JWT также лежит в основе крупных протоколов идентификации. По данным Monofor, токены OpenID Connect по определению являются JWT. Токены доступа OAuth 2.0 тоже чаще всего имеют формат JWT. За кнопкой "Войти через Google" работает именно эта структура.
Их также можно использовать вместе. JWT можно передавать в cookie с флагом HttpOnly. Тогда браузер будет отправлять токен с каждым запросом автоматически, а JavaScript не сможет к нему обратиться.
Распространённые ошибки безопасности при использовании JWT
Самая частая ошибка — записывать в payload данные, которые должны оставаться в тайне. По данным Monofor, стандартный JWT не зашифрован, поэтому в claims нельзя хранить секреты. Пароль, хеш пароля, номер кредитной карты, номер паспорта или ИНН и API-ключ в payload не должны попадать. Достаточно полей, раскрытие которых не причиняет вреда, например идентификатора пользователя и роли.
Вторая ошибка — доверие полю "alg" в header. По данным Wikipedia, специалист по безопасности Тим Маклин сообщил, что в некоторых JWT-библиотеках это поле использовалось для проверки токенов неправильно. Наиболее распространённым случаем было принятие неподписанного токена с alg=none. Злоумышленник изменял payload, удалял подпись и ставил алгоритм "none". Чтобы закрыть уязвимость, сервер фиксирует на своей стороне список допустимых алгоритмов. Если значение "alg" из токена не совпадает с этим списком, запрос отклоняется. Использование актуальной версии библиотеки также обеспечивает эту проверку.
Третья ошибка — выдача токена доступа с длительным сроком жизни. По данным Monofor, срок жизни токенов доступа обычно должен составлять от 5 до 60 минут. Украденный токен в таком случае работает недолго. Есть и ограничение по размеру. По данным Postman, JWT, передаваемый в HTTP-заголовке, должен оставаться меньше 8 КБ, так как некоторые серверы не принимают слишком большие заголовки запроса. Включение в payload списков разрешений или профильных данных быстро превышает это ограничение.
Секретный ключ не должен записываться в исходный код или в публичный репозиторий. Ключ хранится в переменной окружения или в инструменте управления секретами и периодически меняется. Услуга Türk Bilişim Siber Güvenlik & SSL также включает шифрование соединения, по которому передаются токены, через HTTPS. По незашифрованному соединению токен можно прочитать в сети как открытый текст.
Нужна услуга «Автоматическая генерация SEO-статей»?Часто задаваемые вопросы
Может ли любой прочитать содержимое JWT?
Да, тот, кто получил токен, может без труда декодировать части header и payload и прочитать их. Однако изменить содержимое и создать действительный токен без ключа невозможно.
Можно ли отозвать JWT до истечения срока действия?
Напрямую отозвать нельзя, так как сервер не сверяет токен с записью в базе. Если отзыв необходим, идентификатор токена ("jti") заносится в список запрещённых, либо удаляется refresh-токен пользователя.
Где в браузере следует хранить JWT?
Cookie с флагами HttpOnly и Secure не позволяет вредоносному JavaScript, попавшему на страницу, читать токен. localStorage же доступен любому скрипту, поэтому при XSS-атаке токен оказывается открытым.
В чём разница между refresh-токеном и токеном доступа?
Токен доступа отправляется с каждым API-запросом и истекает через несколько минут. Refresh-токен используется только для получения нового токена доступа, живёт дольше, и если сервер отслеживает его как одноразовый, то при краже кражу можно сразу заметить.
Türk Bilişim · Бесплатное предложение
Получите бесплатное предложение: Автоматическая генерация визуалов для соцсетей
Оставьте номер, и мы сразу свяжемся с вами. Разговор бесплатный.
Ваша заявка сохранена на этом устройстве
Сейчас наш сервер недоступен. Заявка будет отправлена автоматически, когда связь восстановится. Чтобы связаться сразу:

Поделиться статьёй
Комментарии
Комментарии
Комментариев пока нет.
















