Что такое «JWT»

При классическом входе сервер хранит у себя сессию и узнаёт пользователя по её номеру в cookie. Это неудобно, когда серверов много или когда к API обращаются мобильные приложения и сторонние сервисы. JWT переносит сведения о пользователе в сам токен и подписывает их. Любой сервер, знающий ключ, проверит подпись и сразу поймёт, кто перед ним и что ему разрешено. Формат описан в RFC 7519.

Чаще всего JWT встречается в REST API, мобильных приложениях и при входе через внешних провайдеров по OpenID Connect, где он служит токеном личности.

Пример: из чего состоит токен

Токен выглядит как три фрагмента через точку: xxxxx.yyyyy.zzzzz. Если раскодировать первые два, получится обычный JSON:

{ "alg": "HS256", "typ": "JWT" }

{ "sub": "1042", "role": "dealer", "iat": 1760000000, "exp": 1760000900 }

Заголовок называет алгоритм подписи. В данных лежат утверждения: sub — идентификатор пользователя, iat — время выдачи, exp — время истечения в секундах Unix-времени. Третья часть — подпись от первых двух. Клиент отправляет токен в каждом запросе:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Ошибки, которые встречаются чаще всего

  • Хранить в токене секреты. Данные только подписаны, а не зашифрованы: их прочитает любой, кто перехватил токен.
  • Доверять алгоритму из заголовка. Сервер должен сам задавать допустимые алгоритмы, иначе возможна подмена, вплоть до варианта none без подписи.
  • Выдавать долгоживущие токены. Отозвать JWT до истечения срока без дополнительного списка нельзя, поэтому токен доступа делают коротким, а для продления используют отдельный токен обновления.
  • Слабый ключ для HS256: короткий секрет подбирается перебором.

JWT и сайты на CMS

WordPress сам не выдаёт JWT: для REST API он использует cookie с одноразовым кодом или пароли приложений, а JWT подключают плагинами. Это разумно, когда к сайту обращается мобильное приложение или отдельный фронтенд. Для обычного сайта, где пользователь входит через браузер, сессия на сервере проще и легче отзывается. Различия между проверкой личности и проверкой прав разобраны в статье про аутентификацию.

Связанные термины

Обновлено: 10 октября 2026

Все термины раздела «Backend» ↗