Erweiterte Funktionen

Dieser Leitfaden beschreibt die erweiterten Funktionen und Möglichkeiten des JWT Parser-Tools für erfahrene Nutzer und Entwickler.

Verlaufsverwaltung

Automatische Verlaufserfassung

Das Tool speichert analysierte Tokens automatisch im lokalen Speicher Ihres Browsers:

• Dauerhafte Speicherung: Der Verlauf bleibt auch nach einem Browser-Neustart erhalten
• Datenschutzorientiert: Die Daten bleiben ausschließlich in Ihrem Browser
• Automatische Bereinigung: Es werden maximal die letzten 50 Tokens gespeichert

Verlaufsaktionen

• Aus dem Verlauf laden: Klicken Sie auf einen Eintrag, um dieses Token erneut zu laden
• Verlauf löschen: Entfernen Sie alle gespeicherten Tokens auf einmal
• Selektives Laden: Wählen Sie bestimmte Tokens für eine erneute Analyse aus

Informationen im Verlauf

Jeder Verlaufseintrag zeigt:

• Algorithmus: Den verwendeten Signaturalgorithmus
• Ablaufzeit: Wann das Token abläuft
• Zeitstempel: Wann das Token analysiert wurde
• Token-Vorschau: Die ersten 50 Zeichen des Tokens

Token-Analysefunktionen

Algorithmen-Erkennung

Das Tool erkennt und zeigt automatisch:

• Symmetrische Algorithmen: HS256, HS384, HS512
• Asymmetrische Algorithmen: RS256, RS384, RS512, ES256, ES384, ES512
• none-Algorithmus: Ungesicherte Tokens (nur für Entwicklung)

Ablaufanalyse

• Ablaufzeit: Wandelt Unix-Zeitstempel in ein lesbares Datum mit Uhrzeit um
• Zeitzone: Zeigt Werte in Ihrer lokalen Zeitzone an
• Abgelaufene Tokens: Kennzeichnet deutlich, ob ein Token bereits abgelaufen ist

Claims-Analyse

• Standard-Claims: Erkennt automatisch RFC 7519-Standard-Claims
• Benutzerdefinierte Claims: Zeigt anwendungsspezifische Claims an
• Verschachtelte Objekte: Verarbeitet auch komplexe Payload-Strukturen

Kopier- und Exportfunktionen

Strukturiertes Kopieren

Beim Kopieren der Ergebnisse erhalten Sie eine strukturierte Ausgabe wie diese:

Header:
{
  "alg": "HS256",
  "typ": "JWT"
}

Payload:
{
  "sub": "1234567890",
  "name": "John Doe",
  "iat": 1516239022,
  "exp": 1516242622
}

Signature:
SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Typische Einsatzfälle fürs Kopieren

• Dokumentation: Für API-Dokumentationen verwenden
• Debugging: Analyseergebnisse mit Teammitgliedern teilen
• Tests: In automatisierten Testszenarien einsetzen
• Berichte: In Sicherheits- oder Audit-Berichte aufnehmen

Fehlerbehandlung und Validierung

Formatvalidierung

Das Tool führt umfassende Prüfungen durch:

• Strukturprüfung: Stellt sicher, dass genau 3 durch Punkte getrennte Teile vorhanden sind
• Base64URL-Prüfung: Prüft, ob jeder Teil gültiges base64url ist
• JSON-Prüfung: Stellt sicher, dass Header und Payload gültiges JSON sind

Fehlermeldungen

Klare und umsetzbare Fehlermeldungen helfen bei der Analyse:

• Ungültiges Format: Konkrete Hinweise zur JWT-Struktur
• Parse-Fehler: Detaillierte Informationen zu fehlgeschlagenen Analysen
• Kodierungsprobleme: Unterstützung bei base64url-Kodierungsfehlern

Integrationsmuster

Integration in Entwicklungsabläufe

1. API-Tests: Tokens aus API-Antworten analysieren
2. Authentifizierungs-Debugging: Tokens während der Entwicklung untersuchen
3. Code-Review: Token-Struktur in Pull Requests prüfen
4. Dokumentation: Beispiele für API-Dokumente erzeugen

Testintegration

• Unit-Tests: Analysierte Daten in Assertions verwenden
• Integrationstests: Token-Strukturen in Testszenarien verifizieren
• Sicherheitstests: Tokens auf potenzielle Sicherheitsprobleme untersuchen

Leistungsaspekte

Verarbeitung im Browser

• Keine Netzwerkaufrufe: Die gesamte Analyse erfolgt im Browser
• Schnelle Verarbeitung: Für die meisten Tokens erhalten Sie sofort Ergebnisse
• Speichereffizient: Geringer Speicherverbrauch
• Offline nutzbar: Funktioniert auch ohne Internetverbindung

Umgang mit großen Tokens

• Größenlimits: Verarbeitet Tokens bis zur Grenze des Browser-Speichers
• Leistung: Für typische JWT-Größen optimiert
• Fehlerbehandlung: Große Tokens werden kontrolliert behandelt

Browser-Kompatibilität

Unterstützte Browser

• Chrome: Vollständig unterstützt (empfohlen)
• Firefox: Vollständig unterstützt
• Safari: Vollständig unterstützt
• Edge: Vollständig unterstützt

Erforderliche Funktionen

• Local Storage: Für die Verlaufsspeicherung
• Clipboard API: Für die Kopierfunktion
• JSON Parsing: Für die Token-Analyse

Sicherheits-Best-Practices

Umgang mit Tokens

• Tokens niemals protokollieren: Vermeiden Sie sensible Tokens in Logs
• Sichere Umgebung: Nur in sicheren, privaten Umgebungen verwenden
• Regelmäßige Bereinigung: Verlauf regelmäßig löschen
• Zugriffskontrolle: Nur autorisierte Nutzer sollten Zugriff haben

Datenschutz

• Nur lokale Speicherung: Es werden keine Daten an externe Server gesendet
• Browser-Isolation: Die Daten bleiben in Ihrem Browser
• Kontextwechsel bereinigen: Daten löschen, wenn Sie den Kontext wechseln

Fehlerbehebung

Häufige Probleme

1. Token wird nicht analysiert: Format und Kodierung prüfen
2. Verlauf wird nicht gespeichert: Prüfen, ob lokaler Speicher im Browser verfügbar ist
3. Kopieren funktioniert nicht: Browser-Berechtigungen für die Zwischenablage prüfen
4. Darstellungsprobleme: Seite neu laden

Debug-Tipps

• Konsole prüfen: Auf JavaScript-Fehler achten
• Format prüfen: Sicherstellen, dass die Token-Struktur korrekt ist
• Mit Beispielen testen: Das integrierte Beispiel-Token verwenden
• Cache leeren: Browser-Cache bei Bedarf löschen

API-Referenz

Token-Struktur

interface ParsedJWT {
  header: string; // Formatierter JSON-String
  payload: string; // Formatierter JSON-String
  signature: string; // Rohsignatur
}

interface JWTInfo {
  algorithm: string; // Signaturalgorithmus
  type: string; // Tokentyp
  expires: string; // Ablaufzeit
}

Verlaufsstruktur

interface HistoryRecord {
  id: string; // Eindeutige Kennung
  token: string; // Vollständiges JWT-Token
  algorithm: string; // Signaturalgorithmus
  expires: string; // Ablaufzeit
  timestamp: number; // Analysezeitpunkt
}

Nächste Schritte

Lesen Sie als Nächstes die Sicherheitshinweise für wichtige Sicherheitsrichtlinien oder sehen Sie sich die Beispiele für reale Nutzungsszenarien an.