So nutzen Sie den JWT-Decoder
- Token einfügen. Ein vorangestelltes „Bearer “ wird automatisch entfernt.
- Header, Payload und Claims lesen. Die drei Teile des Tokens werden farbig hervorgehoben.
- Status prüfen: Ablaufzeit, Gültigkeitsbeginn und Algorithmus.
- Signatur prüfen: Geheimnis (HS) oder öffentlichen PEM-Schlüssel (RS, PS, ES) eingeben und bestätigen.
Wie ist ein JWT aufgebaut?
Ein JSON Web Token (RFC 7519) besteht aus drei Teilen, getrennt durch Punkte: Header, Payload und Signatur. Header und Payload sind JSON-Objekte, die mit URL-sicherem Base64 kodiert sind. Der Header nennt den Algorithmus, etwa HS256 oder RS256, der Payload enthält die Claims, also Angaben über den Benutzer und die Gültigkeit. Die Signatur stellt sicher, dass niemand das Token verändert hat. Wichtig: Der Payload ist nicht verschlüsselt. Jeder, der das Token hat, kann ihn lesen. Speichern Sie deshalb niemals Passwörter oder sensible Daten in einem JWT.
Die wichtigsten Claims
| Claim | Bedeutung |
|---|---|
iss | Aussteller des Tokens |
sub | Subjekt, meist die Benutzer-ID |
aud | Zielgruppe, für die das Token bestimmt ist |
exp | Ablaufzeitpunkt (Unix-Zeitstempel) |
nbf | nicht gültig vor diesem Zeitpunkt |
iat | Ausstellungszeitpunkt |
jti | eindeutige ID des Tokens |
Daneben gibt es verbreitete Claims wie name, email, role, scope oder azp, die der Decoder ebenfalls erklärt. Eigene Claims Ihrer Anwendung werden als „benutzerdefiniert“ markiert.
Ablauf und Gültigkeit
Zeitstempel in JWTs sind Sekunden seit dem 1. Januar 1970 (UTC). Der Decoder rechnet sie in Ihre lokale Zeit um und zeigt zusätzlich die ISO-Darstellung in UTC. Ein Statusbalken meldet, ob das Token abgelaufen ist und wie lange es noch gilt oder ob es erst in der Zukunft gültig wird. Das spart beim Debuggen von Anmeldeproblemen viel Zeit: Häufig ist schlicht ein abgelaufenes Token oder eine falsch gestellte Serveruhr die Ursache für Fehler wie 401 Unauthorized.
Signatur prüfen
Für symmetrische Verfahren (HS256, HS384, HS512) geben Sie das gemeinsame Geheimnis ein, auf Wunsch auch Base64-kodiert. Für asymmetrische Verfahren (RS, PS, ES) fügen Sie den öffentlichen Schlüssel im PEM-Format ein, der mit -----BEGIN PUBLIC KEY----- beginnt. Die Prüfung nutzt die Web-Crypto-Schnittstelle Ihres Browsers. Stimmt die Signatur, wurde das Token mit dem passenden Schlüssel erstellt und nicht verändert. Ein beigefügtes Beispiel-Token ist mit einem Demo-Geheimnis signiert, damit Sie die Funktion sofort ausprobieren können.
Sicherheitshinweise
- Unsignierte Tokens mit
alg: nonemarkiert der Decoder deutlich. Ein Server darf sie niemals akzeptieren. - JWE-Tokens mit fünf Teilen sind verschlüsselt; ihren Inhalt kann nur lesen, wer den Schlüssel besitzt.
- Produktive Tokens sollten Sie nicht in Online-Werkzeuge einfügen, die Daten an einen Server senden. Dieser Decoder arbeitet vollständig lokal, trotzdem gilt: Echte Tokens nach dem Debuggen widerrufen oder ablaufen lassen.
- Geheimnisse für HS256 sollten mindestens 256 Bit lang und zufällig sein.
Typische Fehler beim Debuggen
Liefert eine API trotz Token den Fehler 401, lohnt ein Blick in den Decoder. Häufige Ursachen: Das Token ist abgelaufen, weil die Gültigkeit oft nur 5 bis 60 Minuten beträgt; die Zielgruppe (aud) passt nicht zur aufgerufenen API; der Aussteller (iss) stammt aus einer anderen Umgebung, etwa Test statt Produktion; die Uhr des Servers geht falsch, sodass nbf oder iat in der Zukunft liegen; oder es fehlen benötigte Berechtigungen im Claim scope oder role. Auch ein versehentlich abgeschnittenes Token beim Kopieren aus Logs kommt vor; der Decoder meldet dann, dass ein Teil kein gültiges JSON ist. Prüfen Sie diese Punkte der Reihe nach, bevor Sie den Fehler im Code suchen.
JWT in der Praxis
JWTs werden vor allem für Anmeldungen mit OAuth 2.0 und OpenID Connect verwendet, etwa bei Keycloak, Auth0, Microsoft Entra ID oder Firebase. Das ID-Token beschreibt den angemeldeten Benutzer, das Access-Token berechtigt zum Aufruf von APIs. Mit dem Decoder sehen Sie schnell, welche Angaben ein Anbieter tatsächlich liefert.
Häufige Fragen
Ist der Inhalt eines JWT verschlüsselt?
Nein, Header und Payload sind nur Base64-kodiert und für jeden lesbar. Nur die Signatur schützt vor Veränderung.
Kann ich ein Token ohne Geheimnis dekodieren?
Ja, zum Lesen braucht man kein Geheimnis. Es wird nur für die Signaturprüfung benötigt.
Welche Algorithmen werden geprüft?
HS256/384/512, RS256/384/512, PS256/384/512 und ES256/384/512.
Was bedeutet exp?
Den Ablaufzeitpunkt als Unix-Zeitstempel. Danach muss das Token abgelehnt werden.
Wird mein Token gespeichert oder gesendet?
Nein, die Verarbeitung erfolgt ausschließlich in Ihrem Browser.