Darmowy generator sekretu JWT — HS256/384/512

Czym jest generator sekretu JWT?

// The secret you generate here goes straight into your signing code.
// Node.js with jsonwebtoken — the JWT_SECRET env var holds the key.
import jwt from 'jsonwebtoken';

const secret = process.env.JWT_SECRET; // e.g. base64url value from this tool

// Sign a token with HS256 (HMAC-SHA-256).
const token = jwt.sign({ sub: 'user-42', role: 'member' }, secret, {
  algorithm: 'HS256',
  expiresIn: '15m'
});

// Verify it — pin the algorithm to a whitelist; never trust the token's alg.
const payload = jwt.verify(token, secret, { algorithms: ['HS256'] });

// ---------------------------------------------------------------
// Python with PyJWT — same secret, same algorithm pinning.
// import jwt
// token = jwt.encode({"sub": "user-42"}, key, algorithm="HS256")
// payload = jwt.decode(token, key, algorithms=["HS256"])  # whitelist!

// ---------------------------------------------------------------
// Equivalent-strength CLI generation (32 bytes for HS256):
//   openssl rand -base64 32
//   node -e "console.log(require('crypto').randomBytes(32).toString('base64url'))"
//   python -c "import secrets; print(secrets.token_urlsafe(32))"

Kluczowe funkcje

Przykłady krok po kroku

Algorytm: HS256 · Format: base64url

3sJ9aFq2kP7mWcZ1xL0nVtRbYdGhU8eAoI4QpNlKj0

Algorytm: HS512 · Format: base64url

k2Lp9XqA0mNbVcZ7rT4wYsHfGjUe8RoIdPlNkBvM3xQ1aWtCyZuS6FhEgJ (86 chars)

Kliknij „Kopiuj do .env”

JWT_SECRET=3sJ9aFq2kP7mWcZ1xL0nVtRbYdGhU8eAoI4QpNlKj0

Pokaż polecenie CLI

openssl rand -base64 32

Przełącz ikonę oka

•••••••••••••••••••••••••••••••••••••••••••  ↔  3sJ9aFq2kP7m…

Jak korzystać z generatora sekretu JWT

1. 1

   Wybierz algorytm podpisujący

   Wybierz HS256, HS384 lub HS512. Generator natychmiast stosuje minimalną długość klucza z RFC 7518 §3.2 dla tego wariantu HMAC — 32, 48 lub 64 bajty — więc nigdy nie musisz sprawdzać tej liczby ani ryzykować zbyt małego klucza.

2. 2

   Wybierz format wyjściowy

   base64url jest domyślny — natywne, bezpieczne dla adresów URL kodowanie JWT bez dopełnienia. Przełącz na standardowy base64, jeśli loader tego oczekuje, lub hex, gdy system akceptuje tylko znaki 0–f. Wszystkie trzy kodują te same losowe bajty o identycznej entropii.

3. 3

   Odsłoń i skopiuj sekret

   Sekret jest domyślnie zamaskowany, aby pozostawał poza ekranem podczas pokazu czy udostępniania ekranu. Kliknij ikonę oka, aby go odsłonić, a następnie Kopiuj, aby pobrać surową wartość, lub Kopiuj do .env, aby skopiować wiersz JWT_SECRET=… gotowy do pliku .env lub zmiennej CI.

4. 4

   Generuj ponownie w razie potrzeby

   Kliknij Generuj ponownie po świeży, niezależny sekret pobrany z crypto.getRandomValues. Generuj po jednym na środowisko — nigdy nie używaj ponownie tego samego klucza podpisującego w deweloperce, środowisku przejściowym i produkcji.

5. 5

   Użyj odpowiednika CLI lub przejdź do podpisywania

   Panel CLI pokazuje pasujące jednowierszowce openssl, Node i Python do skryptowego provisioningu. Z sekretem w ręku podpisz token koderem JWT i potwierdź podpis dekoderem JWT.

Częste błędy z sekretem JWT

JWT_SECRET=mySuperSecret123  →  low entropy, brute-forceable

JWT_SECRET=3sJ9aFq2kP7mWcZ1xL0nVtRbYdGhU8eAoI4QpNlKj0  →  32 random bytes

16-byte key with HS256  →  below the 32-byte minimum

32-byte key with HS256  →  meets RFC 7518 §3.2

Math.random()-based key  →  predictable, unsafe

crypto.getRandomValues key  →  full entropy

Service A: raw string · Service B: base64-decoded  →  signatures never match

Both services use the identical stored string  →  signatures verify

Same JWT_SECRET in dev, staging, prod  →  one leak breaks all

A unique secret per environment  →  blast radius contained

jwt.verify(token, secret)  →  accepts the token's alg

jwt.verify(token, secret, { algorithms: ['HS256'] })  →  pinned

Kto korzysta z tego narzędzia

Zapewnij JWT_SECRET dla nowej usługi

Stawiasz API, które wydaje tokeny podpisane HMAC? Wybierz algorytm, którego używa Twoja biblioteka, skopiuj sekret jako wiersz JWT_SECRET=… i wstaw go do środowiska usługi. Wygeneruj odrębny klucz dla deweloperki, środowiska przejściowego i produkcji — nigdy nie współdziel jednego sekretu między środowiskami.

Rotuj skompromitowany lub starzejący się sekret

Gdy podejrzewasz wyciek klucza lub po prostu nadszedł czas na rotację, wygeneruj tutaj świeży sekret, przypisz mu nowy kid i wdróż go z oknem nakładania się, aby aktywne tokeny weryfikowały się aż do wygaśnięcia. Przy potwierdzonej kompromitacji rotuj natychmiast i usuń stary klucz z zestawu akceptowanych.

Zastąp słaby lub ręcznie wpisany klucz

Odziedziczyłeś kod, którego JWT_SECRET to krótka fraza lub skopiowana wartość przykładowa? Taki klucz da się złamać siłą offline. Wygeneruj pełnoentropijny 32-bajtowy zamiennik, podmień go za oknem rotacji i zamknij lukę fałszowania tokenów, zanim zostanie wykorzystana.

Skryptuj generowanie kluczy w pipeline

Potrzebujesz klucza tworzonego w CI lub Dockerfile, a nie ręcznie? Użyj jednowierszowca openssl, Node lub Python z panelu CLI, aby wybić sekret o równej sile wewnątrz skryptu provisioningu, a tej strony użyj, aby zrozumieć długości bajtów i kodowania wytwarzane przez każde polecenie.

Bezpiecznie ucz podpisywania JWT

Przeprowadź zespół przez to, jak działa HS256, nigdy nie odsłaniając prawdziwego klucza produkcyjnego — wygeneruj na ekranie jednorazowy sekret (zamaskowany, dopóki go nie odsłonisz), podpisz przykładowy token koderem JWT i zweryfikuj go dekoderem JWT, tak aby cała pętla podpisywania i weryfikacji była widoczna.

Porównaj rozmiary kluczy HS256, HS384 i HS512

Decydujesz, który wariant HMAC ujednolicić? Przełączaj się między algorytmami, aby zobaczyć, jak rośnie wymagana długość klucza i zakodowany ciąg — 43, 64 i 86 znaków base64url — i wybierz kompromis między siłą a rozmiarem tokenu, który pasuje do Twojego systemu, zanim zapiszesz go w konfiguracji.

Generuj klucze do lokalnej deweloperki

Potrzebujesz szybkiego, prawidłowego sekretu, aby uruchomić lokalny przepływ uwierzytelniania? Wygeneruj jeden jednym kliknięciem, skopiuj go do .env i jesteś odblokowany — z prawdziwym kluczem z CSPRNG, a nie z zaślepką, którą zapomnisz wymienić przed wdrożeniem.

Jak działa generator

crypto.getRandomValues (CSPRNG)

Sekrety są generowane przez wypełnienie Uint8Array za pomocą crypto.getRandomValues, kryptograficznie bezpiecznego generatora liczb pseudolosowych Web Crypto. To to samo źródło entropii, które stoi za generowaniem kluczy Web Crypto. Math.random nie jest używany nigdzie — jest statystycznie przewidywalny i nieprzydatny do żadnego klucza kryptograficznego.

Dobór rozmiaru klucza wg RFC 7518 §3.2

Liczba bajtów na algorytm wynika z wymogu JSON Web Algorithms, by klucz HMAC był co najmniej tak duży jak wynik haszowania: 32 bajty dla HS256 (SHA-256), 48 dla HS384 (SHA-384), 64 dla HS512 (SHA-512). Wybór algorytmu ustawia minimum; generator nie wyemituje klucza poniżej dolnej granicy specyfikacji.

Kodowania RFC 4648 (base64url / base64 / hex)

Surowe bajty są kodowane alfabetami RFC 4648. base64url używa bezpiecznego dla adresów URL alfabetu bez dopełnienia (32 bajty → 43 znaki), standardowy base64 używa +, / i dopełnienia = (→ 44 znaki), a hex zapisuje dwa znaki na bajt (→ 64 znaki). Zmiana formatu ponownie koduje te same bajty — podstawowa entropia pozostaje niezmieniona.

Dlaczego base64url jest domyślny

Komponenty JWT same są kodowane w base64url, a bezpieczny dla adresów URL alfabet bez dopełnienia oznacza, że sekret w base64url nigdy nie wymaga escapowania w nagłówku, adresie URL ani pliku konfiguracji. Znaki + i / oraz końcowe = standardowego base64 mogą się w tych kontekstach łamać, więc base64url jest zachowawczym domyślnym wyborem dla JWT_SECRET.

Formatowanie Kopiuj do .env

Kopiuj do .env emituje JWT_SECRET= w jednym wierszu bez otaczających cudzysłowów — w postaci, którą loadery w stylu dotenv parsują bez modyfikacji. Surowy sekret nigdy nie zawiera znaków wymagających cudzysłowów w pliku .env, więc wiersz można bezpiecznie wkleić w niezmienionej postaci.

Polecenia CLI o równej sile, nie identyczne co do bajtu

Polecenia openssl rand -base64 N, Node randomBytes(N).toString('base64url') i Python secrets.token_urlsafe(N) z panelu CLI pobierają N bezpiecznych losowych bajtów dla wybranego algorytmu. Wytwarzają klucze o równej sile, a nie ten sam ciąg — openssl emituje standardowy base64 z dopełnieniem, więc alfabet i końcowe znaki różnią się od domyślnego base64url tego narzędzia.

Dobre praktyki dla sekretu JWT

Dopasuj długość klucza do algorytmu

Używaj co najmniej 32 bajtów dla HS256, 48 dla HS384 i 64 dla HS512, jak wymaga RFC 7518 §3.2. Ten generator robi to za Ciebie, ale jeśli dobierasz rozmiar klucza ręcznie, nigdy nie schodź poniżej długości wyniku haszowania — zbyt mały klucz HMAC zarówno osłabia podpis, jak i może zostać odrzucony przez restrykcyjne biblioteki.

Zawsze generuj za pomocą CSPRNG, nigdy hasłem

Sekret JWT to dane uwierzytelniające maszyny, których nikt nie musi zapamiętywać, więc poświęć pełną entropię: użyj kryptograficznie bezpiecznego losowego klucza, a nie frazy hasłowej, słowa ze słownika ani ręcznie wpisanego ciągu. Sekrety wybierane przez człowieka są najłatwiejszym celem ataków siłowych offline, które automatyzują narzędzia do łamania JWT.

Używaj unikalnego sekretu na środowisko

Deweloperka, środowisko przejściowe i produkcja powinny mieć własny JWT_SECRET. Współdzielenie jednego klucza oznacza, że wyciek w niskoryzykownym środowisku fałszuje tokeny wszędzie, a rotacja staje się wszystko-albo-nic. Wygeneruj tu osobny sekret dla każdego środowiska i przechowuj każdy w jego własnym zakresie menedżera sekretów.

Przypnij algorytm podczas weryfikacji

Po stronie weryfikującej zawsze przekazuj jawną białą listę algorytmów — algorithms: ['HS256'] w jsonwebtoken, algorithms=["HS256"] w PyJWT — i nigdy nie ufaj polu alg w tokenie. Akceptowanie samodeklarowanego algorytmu tokenu umożliwia klasyczne ataki alg-confusion i alg:none, niezależnie od tego, jak mocny jest Twój sekret.

Rotuj z nagłówkiem kid i nakładającymi się kluczami

Oznacz podpisane tokeny identyfikatorem klucza (kid) i publikuj aktywne klucze przez endpoint JWKS, abyś mógł rotować bez przestoju: podpisuj nowe tokeny nowym kluczem, jednocześnie akceptując stary, dopóki jego tokeny nie wygasną. Przy podejrzeniu kompromitacji pomiń nakładanie i unieważnij stary klucz natychmiast.

Najczęstsze pytania