Рекомендации по безопасной реализации JWT

Безопасность JWT зависит от качества реализации. Спецификация гибкая, а гибкость создаёт уязвимости. Следуйте этим рекомендациям, чтобы избежать распространённых ошибок, которые приводили к обходу аутентификации в рабочих системах.

Всегда явно указывайте ожидаемый алгоритм: jwt.decode(token, key, algorithms=["RS256"]). Никогда не считывайте алгоритм из заголовка токена, чтобы выбрать ключ или путь проверки. Это предотвращает атаки alg=none и смешение ключей.

Токены доступа: 15–60 минут. Токены обновления: 7–30 дней, хранить в cookie-файлах httpOnly (не в localStorage). После истечения срока действия клиент использует токен обновления, чтобы получить новый токен доступа от сервера аутентификации без повторной аутентификации.

Проверяйте aud (аудиторию), чтобы убедиться, что токен выпущен для вашего сервиса, а не для другого. Проверяйте iss (издателя) по URL вашего сервера аутентификации. Без этих проверок будет принят токен другого приложения, подписанный тем же ключом.

Токены доступа храните в памяти (переменной JS) — они удаляются при закрытии вкладки. Токены обновления храните в cookie-файлах httpOnly, Secure, SameSite=Strict — они недоступны JavaScript. Никогда не храните JWT в localStorage — XSS может похитить их.

JWT не сохраняют состояние — встроенного механизма отзыва нет. Варианты: поддерживать список отозванных токенов, который проверяется при каждом запросе; использовать очень короткий срок действия; использовать непрозрачные токены с централизованной проверкой в контекстах с высокими требованиями к безопасности.

Регулярно ротируйте ключи подписи. Публикуйте в JWKS несколько ключей с разными значениями kid. Во время ротации выпускайте новые токены с новым kid, оставляйте старый ключ активным, пока не истекут старые токены, а затем удаляйте старый ключ из JWKS.

Никогда не помещайте конфиденциальные данные (пароли, номера социального страхования, данные банковских карт) в полезную нагрузку JWT — она закодирована в base64url, но не зашифрована. Если вам нужны зашифрованные утверждения, используйте JWE (JSON Web Encryption) или храните конфиденциальные данные на сервере.

Передавайте JWT только через HTTPS. Перехваченный через HTTP JWT позволяет полностью обойти аутентификацию. Устанавливайте для cookie флаг Secure. Используйте HSTS, чтобы предотвратить понижение протокола. Никогда не записывайте полные строки JWT в журналы сервера.

Используйте библиотеки с активной поддержкой: PyJWT 2+, python-jose, auth0/node-jsonwebtoken 9+, Nimbus JOSE + JWT (Java). Не реализуйте проверку JWT с нуля. Регулярно проверяйте базы данных CVE на наличие уязвимостей библиотек.

Проверяйте все векторы атак: отправляйте токен alg=none, токен со смешением RS256→HS256, истёкший токен, токен с неправильной аудиторией и изменённой полезной нагрузкой. Используйте jwt.io для создания тестовых токенов. Добавляйте интеграционные тесты, подтверждающие, что такие токены отклоняются с кодом 401.

Где следует хранить токены обновления в веб-приложении?

Безопасное использование JWT требует фиксированных алгоритмов, короткого срока действия токенов доступа, хранения токенов обновления в cookie-файлах httpOnly, проверки аудитории и издателя, а также ротации ключей. Далее: схемы криптографического разделения секрета.