Najlepsze praktyki bezpiecznej implementacji JWT

Bezpieczeństwo tokenów JWT zależy wyłącznie od ich implementacji. Specyfikacja jest elastyczna, a elastyczność tworzy podatności. Stosuj poniższe dobre praktyki, aby uniknąć typowych problemów, które prowadziły do omijania uwierzytelniania w systemach produkcyjnych.

Zawsze jawnie określaj oczekiwany algorytm: jwt.decode(token, key, algorithms=["RS256"]). Nigdy nie odczytuj algorytmu z nagłówka tokenu w celu wybrania klucza lub ścieżki kodu do weryfikacji. Zapobiega to atakom alg=none i pomieszania kluczy.

Tokeny dostępu: 15–60 minut. Tokeny odświeżające: 7–30 dni, przechowywane w plikach cookie httpOnly (nie w localStorage). Po wygaśnięciu klient używa tokenu odświeżającego, aby uzyskać nowy token dostępu z serwera uwierzytelniania bez ponownego uwierzytelniania.

Waliduj aud (odbiorcę), aby upewnić się, że token został wystawiony dla danej usługi, a nie dla innej. Waliduj iss (wystawcę) względem adresu URL serwera uwierzytelniania. Bez tych kontroli zaakceptowany zostałby token z innej aplikacji podpisany tym samym kluczem.

Tokeny dostępu w pamięci (zmienna JS) — usuwane po zamknięciu karty. Tokeny odświeżające w plikach cookie httpOnly, Secure, SameSite=Strict — niedostępne dla JavaScriptu. Nigdy nie przechowuj JWT w localStorage — XSS może je wykraść.

Tokeny JWT są bezstanowe — nie mają wbudowanego mechanizmu unieważniania. Dostępne opcje: utrzymywanie listy unieważnień (denylist) sprawdzanej przy każdym żądaniu; bardzo krótki czas wygaśnięcia; używanie nieprzezroczystych tokenów z centralnym wyszukiwaniem w kontekstach wymagających wysokiego poziomu bezpieczeństwa.

Regularnie rotuj klucze podpisywania. Publikuj wiele kluczy w JWKS z różnymi wartościami kid. Podczas rotacji: wystawiaj nowe tokeny z nowym kid, pozostaw stary klucz aktywny do wygaśnięcia starych tokenów, a następnie usuń stary klucz z JWKS.

Nigdy nie umieszczaj danych wrażliwych (haseł, numerów ubezpieczenia społecznego, numerów kart kredytowych) w payloadzie JWT — jest on zakodowany w base64url, a nie zaszyfrowany. Użyj JWE (JSON Web Encryption), jeśli potrzebujesz zaszyfrowanych claimów, albo przechowuj dane wrażliwe po stronie serwera.

Przesyłaj tokeny JWT wyłącznie przez HTTPS. Przechwycenie JWT przesyłanego przez HTTP umożliwia pełne ominięcie uwierzytelniania. Ustaw flagę Secure na plikach cookie. Używaj HSTS, aby zapobiegać obniżeniu wersji protokołu. Nigdy nie zapisuj pełnych ciągów JWT w logach serwera.

Używaj dobrze utrzymywanych bibliotek: PyJWT 2+, python-jose, auth0/node-jsonwebtoken 9+, Nimbus JOSE + JWT (Java). Unikaj samodzielnego implementowania weryfikacji JWT. Regularnie sprawdzaj bazy CVE pod kątem podatności bibliotek.

Testuj wszystkie wektory ataku: prześlij token alg=none, token z pomieszaniem RS256→HS256, wygasły token, token z niewłaściwym odbiorcą oraz zmodyfikowany payload. Używaj jwt.io do tworzenia tokenów testowych. Dodaj testy integracyjne, które potwierdzają odrzucenie tych tokenów z kodem 401.

Gdzie należy przechowywać tokeny odświeżające w aplikacji internetowej?

Bezpieczne używanie JWT wymaga przypiętych algorytmów, krótkiego czasu wygaśnięcia tokenów dostępu, przechowywania tokenów odświeżających w plikach cookie httpOnly, walidacji odbiorcy i wystawcy oraz rotacji kluczy. Dalej: kryptograficzne schematy dzielenia sekretu.