JWT-Decoder

JWT ist in RFC 7519 (Mai 2015) definiert; dort wird empfohlen, es wie das englische Wort „jot“ auszusprechen. Die übliche signierte Form besteht aus drei Base64url-Zeichenfolgen, die durch Punkte verbunden sind: header.payload.signature. Der Header nennt in alg den Signaturalgorithmus, etwa HS256 oder RS256, und häufig in kid eine Schlüssel-ID. Die Payload enthält Claims, also JSON-Felder wie sub (der Benutzer), iss (der Aussteller), aud (die vorgesehene Zielgruppe) sowie exp, nbf und iat; das sind Zeitangaben in Sekunden seit dem 1. Januar 1970 UTC. Der Decoder rechnet diese drei in Ihre lokale Zeit und in ISO 8601 um und zeigt Ihnen, ob das Token abgelaufen, noch nicht gültig oder innerhalb seines Gültigkeitsfensters ist.

Base64url ist eine Kodierung, keine Verschlüsselung. Jeder, der ein Token besitzt, kann die Payload genauso lesen, wie diese Seite es tut. Legen Sie deshalb niemals Passwörter, Kartennummern oder andere Geheimnisse in Claims ab. Ein Token mit fünf durch Punkte getrennten Teilen ist ein JWE, also ein verschlüsseltes Token; sein Inhalt ist ohne den Schlüssel nicht lesbar, und der Decoder weist darauf hin. Ein vorangestelltes „Bearer “, das Sie aus einem Authorization-Header kopiert haben, wird automatisch entfernt.

Die Signatur belegt, dass Header und Payload von jemandem mit dem Schlüssel erzeugt und seitdem nicht verändert wurden. Für die Prüfung brauchen Sie diesen Schlüssel: das gemeinsame Geheimnis bei HMAC-Algorithmen wie HS256 oder den öffentlichen Schlüssel des Ausstellers bei RS256, ES256 oder EdDSA. Ein produktives Signaturgeheimnis in eine beliebige Webseite einzufügen, ist keine gute Idee, und ein Decoder, der ohne Schlüssel die Echtheit eines Tokens zusichert, würde falsche Sicherheit vermitteln. Dieses Tool zeigt die Signatur daher an, prüft sie aber nicht. Betrachten Sie das Angezeigte als Behauptung des Tokens, nicht als Tatsache.

Die Prüfung gehört auf Ihren Server, mit einer gepflegten Bibliothek und festgelegtem, erwartetem Algorithmus. Zwei historische Fehler zeigen, warum: die Annahme von alg „none“, womit jeder ein unsigniertes Token fälschen kann, und die Algorithmenverwechslung, bei der ein Server, der RS256 erwartet, dazu gebracht wird, eine HS256-Signatur zu prüfen und den öffentlichen Schlüssel als HMAC-Geheimnis zu verwenden. Ein Decoder dient der Fehlersuche: Sie sehen, welche Claims ein Anbieter ausstellt, erkennen eine falsche Audience oder finden heraus, dass eine Sitzung scheiterte, weil exp vor einer Minute abgelaufen ist. Um die Base64url-Segmente roh zu lesen, nutzen Sie den Base64-Decoder.