So funktioniert es
- Fügen Sie Ihr JWT ein.
- Lesen Sie Header, Claims und Ablaufstatus.
- 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:
| Claim | Bedeutung |
|---|---|
iss | Aussteller: der Dienst, der das Token erstellt hat |
sub | Subjekt: meist die ID des Benutzers |
aud | Zielgruppe: der Dienst, für den das Token gedacht ist |
exp | Ablauf: Nach diesem Moment muss das Token abgelehnt werden |
nbf | Nicht gültig vor diesem Moment |
iat | Ausgestellt: wann das Token erstellt wurde |
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
Bearerwird 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.