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.
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
- Was ein JWT ist
- Aufbau: die drei Teile
- Wie Signieren und Verifizieren funktionieren
- Die Standard-Claims
- Wann man ein JWT nutzt — und wann nicht
- Häufige Fehler
- Ausprobieren: JWT-Decoder
- 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| Teil | Inhalt | Geheim? |
|---|---|---|
| Header | Signaturalgorithmus (alg) und Typ (typ) | Nein — für jeden lesbar |
| Payload | Claims: wer du bist, was du darfst, wann es abläuft | Nein — für jeden lesbar |
| Signatur | Hash aus Header + Payload, mit einem Secret als Schlüssel | Ja — nur der Aussteller kann sie erzeugen |
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
| Claim | Bedeutung | Warum es wichtig ist |
|---|---|---|
iss | Aussteller — wer das Token erstellt hat | Token von Fremden ablehnen |
sub | Subjekt — wessen Token das ist (User-ID) | Die Identität, mit der die App handelt |
aud | Zielgruppe — für welchen Dienst das Token bestimmt ist | Verhindert, dass ein Token für eine App in einer anderen wiederverwendet wird |
exp | Ablauf — Unix-Zeit, nach der es ungültig ist | Begrenzt den Schaden eines gestohlenen Tokens |
iat | Ausgestellt am | Token erkennen, die vor einem Passwortwechsel erstellt wurden |
nbf | Nicht vor | Token, 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: truein 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
secretist 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 kurzesexpund 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.
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.