Zum Inhalt springen

JWT-Decoder und -Debugger

  • Läuft auf Ihrem Gerät
  • Funktioniert offline, sobald geladen

Fügen Sie ein JSON Web Token ein, um Header und Payload zu lesen, das Ablaufdatum zu sehen und die Signatur mit einem Geheimnis oder öffentlichen Schlüssel zu prüfen. Zeit-Claims erscheinen als lesbare Daten. Tokens werden in Ihrem Browser dekodiert und nie übertragen.

So funktioniert es

  1. Fügen Sie Ihr JWT ein.
  2. Lesen Sie Header, Claims und Ablaufstatus.
  3. Geben Sie bei Bedarf ein Geheimnis oder einen öffentlichen Schlüssel ein, um die Signatur zu prüfen.

Warum dieses Tool

  • Lesbare Daten für exp, iat und nbf.
  • Prüft HMAC-, RSA- und ECDSA-Signaturen.
  • Warnt vor Algorithmen wie none.
  • Ihr Token verlässt die Seite nie.

JSON Web Tokens lesen und prüfen

Was in einem Token steckt

Ein JSON Web Token besteht aus drei Stücken Base64-Text, durch Punkte verbunden: einem Kopf, einer Nutzlast und einer Signatur. Der Kopf nennt den Signaturalgorithmus; die Nutzlast enthält die Claims, etwa wer der Benutzer ist und wann das Token abläuft; die Signatur beweist, dass der Ersteller des Tokens den Schlüssel kannte. Fügen Sie ein Token ein, und die ersten beiden Stücke werden dekodiert und als JSON gezeigt, mit den Standard-Claims in einfachen Worten benannt:

ClaimBedeutung
issAussteller: der Dienst, der das Token erstellt hat
subSubjekt: meist die ID des Benutzers
audZielgruppe: der Dienst, für den das Token gedacht ist
expAblauf: Nach diesem Moment muss das Token abgelehnt werden
nbfNicht gültig vor diesem Moment
iatAusgestellt: wann das Token erstellt wurde
Zeiten sind Unix-Zeitstempel; der Decoder zeigt sie als Datumsangaben und sagt Ihnen, ob das Token abgelaufen ist.

Dekodieren ist nicht Verifizieren

Jeder kann ein JWT dekodieren; die Nutzlast ist nicht verschlüsselt, nur kodiert. Legen Sie also nie Geheimnisse in ein Token, und vertrauen Sie den Claims eines Tokens nie, bevor seine Signatur geprüft wurde. Um eines hier zu verifizieren, fügen Sie den Schlüssel ein:

  • HS256, HS384, HS512 nutzen ein gemeinsames Geheimnis, auf beiden Seiten dasselbe. Haken Sie die Base64-Option an, wenn das Geheimnis so gespeichert ist.
  • RS-, PS- und ES-Algorithmen nutzen ein Schlüsselpaar: Das Token wird mit einem privaten Schlüssel signiert und mit dem öffentlichen geprüft, den Sie als PEM-Schlüssel, Zertifikat oder JWK einfügen können.

Ein mit alg: none signiertes Token hat überhaupt keine Signatur, und der Decoder warnt Sie: Ein Server, der es akzeptiert, würde jedem vertrauen, der die Nutzlast bearbeitet. Bibliotheken sollte man immer sagen, welche Algorithmen sie akzeptieren dürfen.

Produktions-Tokens privat halten

Ein gültiges Token ist ein Schlüssel: Wer es besitzt, kann bis zu seinem Ablauf als dieser Benutzer handeln. Deshalb läuft dieser Decoder vollständig in Ihrem Browser, und deshalb sollten Sie bei Online-Werkzeugen vorsichtig sein, die das Token an einen Server schicken. Nutzen Sie wenn möglich Test-Tokens, und betrachten Sie jedes echte Token, das Sie irgendwo öffentlich eingefügt haben, als geleakt.

Test-Tokens erstellen

Der Tab Kodieren signiert Tokens mit Ihrem eigenen Kopf, Ihrer eigenen Nutzlast und Ihrem eigenen Schlüssel, mit jedem der zwölf Algorithmen. Er kann den Ausstellungszeitpunkt und einen Ablauf eine gewählte Zahl von Minuten in der Zukunft hinzufügen. Nützlich, um zu testen, wie eine API mit abgelaufenen Tokens, falschen Zielgruppen oder fehlenden Claims umgeht, ohne eine echte Anmeldung anzurühren.

Wenn etwas schiefgeht

  • Es meldet, dass das Token ungültig ist. Ein JWT muss genau zwei Punkte haben. Prüfen Sie, ob beim Kopieren nichts abgeschnitten wurde; ein vorangestelltes Bearer wird für Sie entfernt.
  • Die Signatur lässt sich nicht verifizieren. Der Schlüssel ist falsch, das Geheimnis sollte als Base64 gelesen werden, oder das Token wurde nach dem Signieren verändert.
  • Es meldet, dass das Token abgelaufen ist, aber der Server akzeptiert es. Der Server erlaubt vielleicht etwas Spielraum bei der Uhrzeit oder prüft den Ablauf gar nicht, was sich zu beheben lohnt.

Fragen und Antworten

Ist es sicher, ein echtes Token einzufügen?

Die Dekodierung passiert lokal, und nichts wird gesendet. Behandeln Sie Produktionstokens trotzdem als Geheimnisse und nutzen Sie nach Möglichkeit Testtokens.

Kann es eine Signatur prüfen?

Ja, mit dem gemeinsamen Geheimnis für HS256 oder dem öffentlichen Schlüssel für RS256 und ES256.

Warum wird mein Token als abgelaufen angezeigt?

Der Claim exp ist eine Unix-Zeit. Das Tool vergleicht sie mit der Uhr Ihres Geräts.

Esc