Was ist JWT? Aufbau, Signatur & sichere Nutzung

Drei Base64url-Teile, getrennt durch Punkte — ein Header, ein Payload und eine Signatur. Lerne, was jeder Teil beweist, was er nicht beweist, und die fünf Fehler, die ein JWT zum Sicherheitsloch machen.

📂 Grundlagen für Entwickler ⏱ Etwa 11 Minuten 📶 Fortgeschritten 🛠️ Passt zu: JWT-Decoder

Was du lernen wirst

  • Lies ein JWT und nenne seine drei Teile
  • Erkläre, was die Signatur beweist — und was sie nicht beweist
  • Nutze die Standard-Claims (exp, iss, aud, sub) richtig
  • Entscheide, wann ein JWT eine serverseitige Session schlägt (und wann es verliert)
  • Vermeide die fünf klassischen JWT-Sicherheitsfehler
In diesem Guide
  1. Was ein JWT ist
  2. Aufbau: die drei Teile
  3. Wie Signieren und Verifizieren funktionieren
  4. Die Standard-Claims
  5. Wann man ein JWT nutzt — und wann nicht
  6. Häufige Fehler
  7. Ausprobieren: JWT-Decoder
  8. Häufige Fragen

Was ein JWT ist

A JSON Web Token (JWT) ist eine kompakte, URL-sichere Art, einen signierten Claim zwischen zwei Parteien zu übergeben. Es sieht so aus:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IlZhbGV2IiwiYWRtaW4iOnRydWUsImlhdCI6MTUxNjIzOTAyMn0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Drei Blöcke, getrennt durch Punkte: header.payload.signature. Ein Server erstellt eines, nachdem du dich angemeldet hast, gibt es dir, und du schickst es mit jeder Anfrage zurück — normalerweise in einem Authorization: Bearer <token> Header. Der Server prüft die Signatur und vertraut den Claims darin, ohne etwas in einer Datenbank nachzuschlagen. Diese „No-Lookup“-Eigenschaft ist der ganze Sinn — und, wie wir sehen werden, auch die größte Schwäche.

Aufbau: die drei Teile

Jeder Teil ist Base64url-kodiertes JSON (Base64 mit +// ersetzt durch -/_ und Padding entfernt, damit es in einer URL überlebt). Wenn du das Beispiel oben dekodierst, erhältst du:

// Header — how the token is signed
{ "alg": "HS256", "typ": "JWT" }

// Payload — the claims (statements about the user)
{ "sub": "1234567890", "name": "Valev", "admin": true, "iat": 1516239022 }

// Signature — HMAC-SHA256 over header.payload, with a secret key
TeilInhaltGeheim?
HeaderSignaturalgorithmus (alg) und Typ (typ)Nein — für jeden lesbar
PayloadClaims: wer du bist, was du darfst, wann es abläuftNein — für jeden lesbar
SignaturHash aus Header + Payload, mit einem Secret als SchlüsselJa — nur der Aussteller kann sie erzeugen
Der Payload ist kodiert, nicht verschlüsselt. Jeder, der das Token bekommt, kann es dekodieren und jeden Claim lesen — deine User-ID, deine E-Mail, dein Admin-Flag. Packe niemals Passwörter, Secrets oder sensible persönliche Daten in ein JWT. Wenn der Payload geheim bleiben muss, brauchst du JWE (verschlüsseltes JWT), kein einfaches JWT.

Wie Signieren und Verifizieren funktionieren

Um die Signatur zu erzeugen, nimmt der Aussteller base64url(header) + "." + base64url(payload) und signiert sie:

HMAC-SHA256(secret, header + "." + payload)   // HS256: shared secret
RS256: sign with a private key, verify with a public key

Die Verifizierung ist dieselbe Berechnung in umgekehrter Richtung: Der Server berechnet die Signatur über den empfangenen Header und Payload mit seinem eigenen Secret neu und vergleicht sie. Wenn auch nur ein Zeichen des Payloads geändert wurde — etwa wenn man "admin": false in true ändert — stimmt die Signatur nicht mehr und das Token wird abgelehnt.

Zwei Algorithmus-Familien sind wichtig. Symmetrisch (HS256): Ein gemeinsames Secret signiert und verifiziert — einfach, aber jeder mit dem Secret kann Token fälschen, also darf nur der Aussteller es besitzen. Asymmetrisch (RS256/ES256): Ein privater Schlüssel signiert, ein öffentlicher Schlüssel verifiziert — der Prüfer kann ein anderer Dienst sein; so funktioniert Föderation im Stil von „Mit Google anmelden“.

Die Standard-Claims

ClaimBedeutungWarum es wichtig ist
issAussteller — wer das Token erstellt hatToken von Fremden ablehnen
subSubjekt — wessen Token das ist (User-ID)Die Identität, mit der die App handelt
audZielgruppe — für welchen Dienst das Token bestimmt istVerhindert, dass ein Token für eine App in einer anderen wiederverwendet wird
expAblauf — Unix-Zeit, nach der es ungültig istBegrenzt den Schaden eines gestohlenen Tokens
iatAusgestellt amToken erkennen, die vor einem Passwortwechsel erstellt wurden
nbfNicht vorToken, die erst später gültig werden

Darüber hinaus fügen Anwendungen ihre eigenen Claims hinzu — Rollen, Berechtigungen, einen Anzeigenamen. Halte den Payload klein: Das Token wird mit jeder Anfrage gesendet, also ist ein 5-KB-Token eine Steuer auf jeden einzelnen Aufruf.

Wann man ein JWT nutzt — und wann nicht

JWTs glänzen, wenn die Verifizierung ohne Datenbank-Roundtrip funktionieren muss oder über Dienste hinweg, die keinen gemeinsamen Session-Store haben: APIs, Microservices und Single Sign-on. Der Prüfer braucht nur den Schlüssel.

Sie verlieren in einem wichtigen Punkt: Man kann sie nicht einfach widerrufen. Eine serverseitige Session kann in dem Moment gelöscht werden, in dem sich ein Nutzer abmeldet oder sein Passwort ändert; ein JWT bleibt gültig, bis es abläuft, weil es nichts zu löschen gibt. Die Standard-Abhilfen sind kurze Ablaufzeiten (Minuten, nicht Tage) plus Refresh-Token — ein langlebiges Token, das nur jemals an den Login-Endpunkt gesendet wird, um frische, kurzlebige JWTs zu erzeugen — oder eine Widerrufsliste, die leise den Datenbank-Lookup wieder einführt, den das JWT eigentlich vermeiden sollte.

Faustregel: Wenn du eine App und eine Datenbank hast, ist ein klassisches Session-Cookie einfacher und sicherer. Greife zu JWT, wenn du viele Dienste hast oder wenn das Token eine Vertrauensgrenze überschreiten muss.

Häufige Fehler

  • Einem clientseitig dekodierten Token vertrauen. Dekodieren beweist nichts — nur die Signaturprüfung. Das admin: true in einem dekodierten Payload ist ein Claim, keine Tatsache, bis die Signatur geprüft ist.
  • Akzeptieren von alg: none. Ein unsigniertes Token muss abgelehnt werden. Bibliotheken, die es trotzdem akzeptieren, sind die älteste JWT-Schwachstelle überhaupt — und sie taucht immer noch auf.
  • Schwache oder geleakte Secrets. HS256 mit dem Secret secret ist in Sekunden fälschbar. Nutze ein langes, zufälliges Secret, rotiere es und commite es niemals.
  • Kein Ablauf (exp). Ein gestohlenes Token funktioniert dann für immer. Setze ein kurzes exp und nutze Refresh-Token.
  • Secrets in den Payload packen. Base64url ist keine Verschlüsselung — jeder kann es lesen. Siehe den Hinweis oben.
  • Token in localStorage speichern. Jede Cross-Site-Scripting-Lücke (XSS) lässt einen Angreifer es lesen. HttpOnly-Cookies sind das sicherere Zuhause für Browser-Token.

Ausprobieren: JWT-Decoder

Füge ein Token in den JWT-Decoder ein und sieh zu, wie es sich in Header, Payload und menschenlesbare Daten aufteilt — der schnellste Weg, die Struktur zu sehen, die dieser Guide beschreibt.

JWT-Decoder öffnen →

Weiterlernen

Häufige Fragen

Ist ein JWT verschlüsselt?

Nein. Ein Standard-JWT (JWS) ist signiert, nicht verschlüsselt — der Payload ist Base64url, das jeder dekodieren kann. Verschlüsselung ist ein separates Format, JWE, das genutzt wird, wenn die Inhalte selbst geheim bleiben müssen.

Wie widerrufe ich ein JWT, wenn sich ein Nutzer abmeldet?

Du kannst es nicht direkt löschen — es bleibt gültig bis zum Ablauf (exp). Die praktischen Antworten sind kurze Ablaufzeiten mit Refresh-Token oder eine serverseitige Denylist widerrufener Token-IDs (der jti-Claim), die an sensiblen Endpunkten geprüft wird.

JWT oder Session-Cookie — was soll ich wählen?

Ein Session-Cookie für eine einzelne App mit Datenbank: einfacher, sofort widerrufbar. Ein JWT für APIs und Microservices, bei denen Prüfer keinen Session-Store teilen können, oder bei denen Token Dienstgrenzen überschreiten. Viele Systeme nutzen beides: eine Session für den Browser, JWTs für Service-zu-Service-Aufrufe.

Wo soll ich ein JWT im Browser speichern?

In einem HttpOnly-, Secure-, SameSite-Cookie — JavaScript kann es nicht lesen, also kann XSS es nicht stehlen. localStorage ist bequem, aber von jedem Skript auf der Seite lesbar, auch von einem eingeschleusten.

Kann ich ein JWT ohne das Secret dekodieren?

Ja — das Dekodieren von Header und Payload braucht überhaupt keinen Schlüssel; nur das Verifizieren der Signatur. Deshalb kann dir das JWT-Decoder-Tool den Inhalt eines Tokens sofort zeigen — und deshalb darfst du niemals Secrets in den Payload packen.