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.payloadmit 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 wiehttps://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, derenaudnicht 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 vonheader.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.jsonabgerufen und überkidzugeordnet 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.