GameParticles
Entwickler

Ein JWT dekodieren und seine Claims sicher lesen

Dekodiere ein JWT über seine drei base64url-Segmente, lies Claims wie iss, sub und exp und erfahre, warum Dekodieren nicht dasselbe ist wie Verifizieren.

Aktualisiert

Ein JWT besteht aus drei base64url-kodierten Segmenten, getrennt durch Punkte: Header, Payload und Signatur. Um die Claims zu lesen, teilst du an ., dekodierst die ersten beiden Segmente mit base64url und parst das resultierende JSON. Das Dekodieren braucht keinen Schlüssel, beweist aber auch nichts; nur die Verifizierung der Signatur sagt dir, dass das Token echt ist.

Aufbau eines Tokens

Ein typisches JWT sieht so aus: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0IiwibmFtZSI6IkFkYSIsImlhdCI6MTUxNjIzOTAyMn0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c. Die drei Teile sind:

  • Header: {"alg":"HS256","typ":"JWT"}. Gibt an, mit welchem Algorithmus das Token signiert wurde, und optional eine Schlüssel-ID (kid).
  • Payload: {"sub":"1234","name":"Ada","iat":1516239022}. Die Claims, also die Daten, um die es dir eigentlich geht.
  • Signatur: Bytes, die entstehen, wenn header.payload mit dem Schlüssel des Ausstellers signiert wird. Kein JSON, sie lässt sich also nicht in etwas Lesbares dekodieren.

Jeder JWT-Header beginnt mit eyJ, weil {" in Base64 genau dazu wird. Wenn du eyJ siehst, hast du mit ziemlicher Sicherheit ein JWT vor dir.

Von Hand dekodieren

Die Segmente verwenden base64url, nicht Standard-Base64: - statt +, _ statt / und kein =-Padding. Die meisten Decoder akzeptieren das URL-sichere Alphabet, manche bestehen aber auf Padding. Um in einem strengen Tool zu dekodieren, ersetzt du die Zeichen und hängst = an, bis die Länge ein Vielfaches von vier ist. Dann dekodierst du und hast JSON-Text.

In JavaScript lautet die schnelle Variante JSON.parse(atob(token.split(".")[1].replace(/-/g,"+").replace(/_/g,"/"))). In Python übernimmt base64.urlsafe_b64decode(seg + "=" * (-len(seg) % 4)) die Padding-Rechnung für dich. Auf der Kommandozeile funktioniert cut -d. -f2 | base64 -d, sobald das Padding korrigiert ist.

Wenn du nur sehen willst, was drinsteckt, ohne Code zu schreiben, füge das Token in den JWT-Decoder ein. Er trennt die Segmente, dekodiert Header und Payload, erklärt jeden Standard-Claim und zeigt einen Countdown bis zum Ablauf.

Um die Bytes eines einzelnen Segments selbst zu untersuchen, gibst du es nach dem Korrigieren des Paddings in den Base64-Decoder; die Ausgabe ist der rohe JSON-Text.

Die Claims, denen du begegnest

Registrierte Claims sind Kurznamen, die in RFC 7519 definiert sind. Die gängigen:

  • iss (Issuer): wer das Token erstellt hat, meist eine URL wie https://accounts.example.com.
  • sub (Subject): der Benutzer oder Principal, um den es im Token geht.
  • aud (Audience): für wen das Token bestimmt ist. Deine API sollte Tokens ablehnen, deren aud nicht zu ihr passt.
  • exp (Expiration): Unix-Zeitstempel in Sekunden, nach dem das Token ungültig ist.
  • nbf (Not Before): Das Token ist vor diesem Zeitpunkt ungültig.
  • iat (Issued At): wann es erstellt wurde.
  • jti: eindeutige Token-ID, die Replay-Angriffe verhindern soll.

Alles andere ist benutzerdefiniert: email, roles, scope, tenant_id und so weiter. Benutzerdefinierte Claims bedeuten das, was der Aussteller festlegt, sieh also in der Dokumentation deines Identity-Providers nach, statt zu raten.

Zeitstempel sind Sekunden, nicht Millisekunden. 1516239022 ist der 18. Januar 2018. Ein Wert wie 1516239022000 ist ein Fehler auf der Seite des Ausstellers und wird von jedem korrekten Validator als Datum gelesen, das Zehntausende Jahre entfernt liegt.

Dekodieren ist nicht Verifizieren

Das ist der Teil, den viele falsch verstehen. Jeder kann ein Token mit {"sub":"admin","roles":["superuser"]} im Payload und einer beliebigen Zeichenkette an der Stelle der Signatur bauen. Es lässt sich einwandfrei dekodieren. Es ist außerdem wertlos, solange die Signatur nicht zum Schlüssel des Ausstellers passt.

Die Verifizierung hängt von alg ab:

  • HS256, HS384, HS512: HMAC mit einem gemeinsamen Secret. Der Prüfer braucht dasselbe Secret, das der Aussteller verwendet hat. Die Signatur ist ein HMAC-SHA-Digest von header.payload; ein Hash-Generator zeigt, wie ein einfacher SHA-256-Digest aussieht, aber HMAC mischt zusätzlich den Schlüssel ein, die Verifizierung gehört also in eine Bibliothek auf deinem Server.
  • RS256, ES256, PS256: asymmetrisch. Der Aussteller signiert mit einem privaten Schlüssel; du verifizierst mit dem öffentlichen Schlüssel, der typischerweise von einem JWKS-Endpunkt wie /.well-known/jwks.json abgerufen und über kid zugeordnet wird.
  • none: keine Signatur. Lehne solche Tokens rundweg ab.

Nutze eine gepflegte Bibliothek (jsonwebtoken oder jose in Node, PyJWT in Python, java-jwt auf der JVM) und übergib ihr die Liste der erwarteten Algorithmen, den Aussteller und die Audience. Lass niemals den alg-Header des Tokens selbst entscheiden, wie es verifiziert wird; das ist die Ursache mehrerer Umgehungen aus der Praxis.

Dekodiere, um zu debuggen. Verifiziere, um zu vertrauen. Ein dekodierter Claim ist ein Hinweis darauf, was der Aussteller beabsichtigt hat, und kein Beweis für irgendetwas, bis die Signatur serverseitig geprüft wurde.

Sicherer Umgang beim Debuggen

Ein JWT ist ein Bearer-Credential: Wer es besitzt, kann es verwenden, bis es abläuft. Füge Tokens nur in Tools ein, die im Browser laufen und sie nicht übertragen. Bevorzuge abgelaufene Tokens oder solche aus einer Staging-Umgebung, wenn du sie in Tickets teilst. Entferne das Signatursegment, bevor du ein Token im Chat postest; die ersten beiden Segmente zeigen weiterhin die Claims, und das Token ist nicht mehr verwendbar.

Weitere Tools zum Dekodieren und Untersuchen findest du in der Kategorie Entwickler.

Probier es aus

Füge ein Token in den JWT-Decoder ein, um den Header, jeden Claim mit kurzer Erklärung, den Signaturalgorithmus und die verbleibende Zeit bis exp zu sehen. Nichts verlässt deinen Browser.

Tools in diesem Ratgeber

Häufige Fragen

Warum beginnt jedes JWT mit eyJ?

Weil der Header JSON ist, das mit einer geschweiften Klammer und einem doppelten Anführungszeichen beginnt, und die Zeichen {" in Base64 zu eyJ werden. Dasselbe Präfix steht meist auch am Anfang des Payload-Segments.

Kann ich eine JWT-Signatur im Browser verifizieren?

Ein RS256- oder ES256-Token kannst du nur verifizieren, wenn du den öffentlichen Schlüssel des Ausstellers hast. HS256-Tokens brauchen das gemeinsame Secret, das niemals in einem Browser liegen sollte. In der Praxis verifizierst du auf dem Server mit einer gepflegten Bibliothek.

Ist der exp-Claim in Sekunden oder Millisekunden angegeben?

In Sekunden seit der Unix-Epoche, gemäß RFC 7519. Ein 13-stelliger Wert ist ein Zeitstempel in Millisekunden und weist auf einen Fehler auf der ausstellenden Seite hin.

Ist es sicher, ein JWT in einen Online-Decoder einzufügen?

Nur wenn der Decoder clientseitig läuft und nichts an einen Server sendet. Selbst dann solltest du abgelaufene Tokens oder solche aus einer Staging-Umgebung bevorzugen, denn ein gültiges JWT ist ein Bearer-Credential, das für jeden funktioniert, der es besitzt.

Weitere Entwickler-Ratgeber

JSON Formatter
Entwickler · Formatiere, validiere und minifiziere JSON mit Syntaxhervorhebung.
↵
Base64 kodieren / dekodieren
Entwickler · Kodiere Text in Base64 oder dekodiere Base64 zurück in Klartext.
↵
URL-Encoder / -Decoder
Entwickler · Kodiere oder dekodiere URL-Bestandteile und Query-Strings.
↵
Hash-Generator
Entwickler · Generiere MD5-, SHA-1-, SHA-256- und SHA-512-Hashes.
↵
UUID-Generator
Entwickler · Generiere UUIDs v4 (zufällig) massenweise mit einem Klick.
↵
Regex-Tester
Entwickler · Teste reguläre Ausdrücke an Text mit Live-Hervorhebung der Treffer.
↵
Wörter zählen
Text · Zähle Wörter, Zeichen, Sätze, Absätze und die Lesezeit.
↵
Groß-/Kleinschreibung umwandeln
Text · Wandle Text in GROSS, klein, Titel, camelCase, snake_case und mehr um.
↵
Listen-Sortierer
Text · Sortiere, kehre um, mische und bereinige Textlisten von Duplikaten.
↵
Markdown-Vorschau
Text · Schreibe Markdown und sieh die gerenderte Live-Vorschau direkt daneben.
↵
Prozentrechner
Zahlen · Berechne Prozentwerte, Zu- und Abnahmen und den Prozentanteil einer Zahl.
↵
Farbkonverter
Farben · Rechne Farben sofort zwischen HEX, RGB, HSL und HSV um.
↵
Snake
Arcade · Friss, wachse und meide die Wände. Ein zeitloser Klassiker.
↵
2048
Rätsel · Schiebe Kacheln und verbinde sie bis zur legendären 2048.
↵
Word Grid
Rätsel · Errate das versteckte Wort mit fünf Buchstaben in sechs Versuchen dank Farbhinweisen.
↵
Sudoku
Rätsel · Fülle das 9x9-Gitter mit Logik. Vier Stufen von leicht bis Experte.
↵
Minesweeper
Strategie · Räume das Minenfeld mit Zahlenhinweisen. Klassische Logik, drei Stufen.
↵
Breakout
Arcade · Zerschlage alle Steine mit Schläger und Ball. Power-ups, Combos, endlose Level.
↵
Tipptraining
Casual · Steigere WPM und Genauigkeit mit Übungen von 30 Sekunden bis 5 Minuten. Finde deine Schwachstellen.
↵
TypeRunner
Arcade · Tipp-Rennen im Mehrspielermodus. Fordere Freunde per Link heraus, schlage Computerläufer oder jage deinen Geist.
↵
Typing Blocks
Arcade · Tippe jedes Wort, bevor sein Holzblock landet. Liegst du daneben, wächst der Stapel zur Linie.
↵
Bubble Shooter
Arcade · Ziele, spiele über die Wände und lass Gruppen aus drei oder mehr Blasen platzen.
↵
Road Rush
Arcade · Fahre gegen sieben Rivalen durch den Verkehr und schlag dich an die Spitze.
↵