issIssuer
Identifiziert die Stelle, die das JWT ausgestellt hat.
Validierung: Exakt mit einem bereits vertrauenswürdigen Issuer der Anwendung vergleichen.
JWT-Entwicklerreferenz
Beim Debugging lese ich Claims im Kontext: Wer hat ausgestellt, für wen gilt der Token, wann ist er gültig und welche Autorisierungsdaten versteht die Anwendung?
48 / 48
issIdentifiziert die Stelle, die das JWT ausgestellt hat.
Validierung: Exakt mit einem bereits vertrauenswürdigen Issuer der Anwendung vergleichen.
subIdentifiziert das Subject innerhalb des Namespace des Issuers.
Validierung: Erst nach Issuer-Validierung und nur in dessen Namespace interpretieren.
audIdentifiziert die vorgesehenen Empfänger des JWT.
Validierung: Die vom Resource Server erwartete Audience muss enthalten sein.
expZeitpunkt, nach dem das JWT nicht mehr akzeptiert werden darf.
Validierung: Nach exp ablehnen; nur eine kleine konfigurierte Clock Tolerance zulassen.
nbfZeitpunkt, vor dem das JWT nicht akzeptiert werden darf.
Validierung: Vor nbf ablehnen, außer innerhalb der ausdrücklich konfigurierten Clock Tolerance.
iatZeitpunkt, zu dem das JWT ausgestellt wurde.
Validierung: Für Age/Lifetime-Policy verwenden und unplausible Zukunftswerte ablehnen.
jtiEindeutiger Bezeichner für das JWT.
Validierung: Nur mit serverseitigem Zustand kombinieren, wenn Replay-Schutz oder Revocation dies benötigt.
azpIdentifiziert die Partei, für die das ID Token ausgestellt wurde.
Validierung: Bei mehreren Audiences oder entsprechender Client-Policy prüfen.
nonceBindet ein ID Token an die zugehörige Browser/Client-Anfrage.
Validierung: Exakt mit dem für den Authorization Request gespeicherten Nonce vergleichen.
auth_timeZeitpunkt der Endnutzer-Authentifizierung.
Validierung: Nutzen, wenn max_age oder Reauthentication vom Alter der Anmeldung abhängt.
acrErreichte Authentication Context Class.
Validierung: Nur Assurance Levels akzeptieren, die die Anwendung ausdrücklich versteht.
amrTatsächlich verwendete Authentifizierungsmethoden.
Validierung: Aus unbekannten Werten kein Assurance Level ableiten; Issuer-Semantik beachten.
at_hashHash-abgeleiteter Wert zur Bindung eines Access Tokens an ein ID Token.
Validierung: Validieren, wenn OIDC Flow/Response Type es erfordert.
c_hashHash-abgeleiteter Wert zur Bindung eines Authorization Codes an ein ID Token.
Validierung: Validieren, wenn der OIDC Response Type es erfordert.
s_hashBindet in bestimmten OIDC/FAPI-Profilen state an eine signierte Antwort.
Validierung: Nur validieren, wenn das aktive OIDC/FAPI-Profil es verlangt.
sidIdentifiziert eine Session beim OpenID Provider.
Validierung: Als issuer-gebundene Session-Metadaten behandeln, nicht als globale User-ID.
nameVollständiger Anzeigename des Endnutzers.
Validierung: Profilwert; nicht als stabile Autorisierungs-ID verwenden.
given_nameVorname des Endnutzers.
Validierung: Nur für Darstellung verwenden und Lokalisierung berücksichtigen.
family_nameNachname des Endnutzers.
Validierung: Keine Eindeutigkeit annehmen.
middle_nameZweiter Vorname des Endnutzers.
Validierung: Als optionalen Profilwert behandeln.
nicknameSpitzname des Endnutzers.
Validierung: Nur für Darstellung verwenden.
preferred_usernameBevorzugter kurzer Benutzername.
Validierung: Keine globale Eindeutigkeit oder Unveränderlichkeit annehmen.
profileURL der Profilseite.
Validierung: URL-Behandlung vor dem Rendern eines Links validieren.
pictureURL des Profilbilds.
Validierung: Beim Rendern als nicht vertrauenswürdigen Remote-Inhalt behandeln.
websiteURL der Website des Endnutzers.
Validierung: Als nicht vertrauenswürdige Profildaten behandeln.
emailBevorzugte E-Mail-Adresse.
Validierung: Nur als verifiziert behandeln, wenn email_verified=true und der Issuer vertrauenswürdig ist.
email_verifiedZeigt an, ob der Issuer die Kontrolle über die E-Mail geprüft hat.
Validierung: Nur mit vertrauenswürdigem Issuer und bekannter Prüfmethodik verwenden.
genderVom Issuer bereitgestellte Geschlechtsangabe.
Validierung: Datensparsamkeit beachten, wenn der Wert nicht benötigt wird.
birthdateGeburtsdatum des Endnutzers.
Validierung: Sensibler Profilwert; nicht als Authentifizierungsfaktor verwenden.
zoneinfoZeitzonenkennung des Endnutzers.
Validierung: Nur für Darstellung/Präferenzen verwenden.
localeLocale-Präferenz des Endnutzers.
Validierung: Für Darstellung nutzen, nicht für Trust Decisions.
phone_numberBevorzugte Telefonnummer.
Validierung: Nur als verifiziert behandeln, wenn phone_number_verified=true und der Issuer vertrauenswürdig ist.
phone_number_verifiedZeigt an, ob der Issuer die Kontrolle über die Nummer geprüft hat.
Validierung: Nach Issuer-Policy und verwendeter Prüfmethodik interpretieren.
addressStrukturiertes Objekt für die Postadresse.
Validierung: Verschachtelte Felder vor Darstellung prüfen und als sensible Daten behandeln.
updated_atZeitpunkt der letzten Profilaktualisierung.
Validierung: Nur als Metadatum zur Profilaktualität verwenden.
client_idIdentifiziert den OAuth Client des Access Tokens.
Validierung: Nur vergleichen, wenn die Resource-Server-Policy einen bestimmten Client verlangt.
scopeDelegierte Berechtigungen des Access Tokens.
Validierung: Nur Scopes autorisieren, die die Ressource versteht und die zur Audience passen.
rolesRollenwerte für Autorisierungsentscheidungen.
Validierung: Issuer/Resource-Semantik definieren und unbekannte Rollen standardmäßig ablehnen.
groupsGruppenmitgliedschaften für Autorisierungsentscheidungen.
Validierung: Keine gemeinsame Benennung oder Hierarchie über verschiedene Issuer annehmen.
entitlementsEntitlements für Rechte oder Berechtigungen.
Validierung: Jedes Entitlement explizit auf erlaubte Aktionen abbilden.
cnfBestätigungsinformationen für einen Proof-of-Possession-Schlüssel.
Validierung: Die vom Token/Profil geforderte Confirmation-Methode tatsächlich validieren.
actIdentifiziert den handelnden Akteur bei Delegation oder Impersonation.
Validierung: Actor und Subject in Autorisierung und Audit getrennt behandeln.
may_actIdentifiziert Parteien, die für das Subject handeln dürfen.
Validierung: Nur in Token-Exchange-Designs mit expliziter Delegation-Policy verwenden.
permissionsPrivate Liste erlaubter Anwendungsaktionen.
Validierung: Issuer, Audience und Permission-Semantik dieser privaten Claims klar definieren.
rolePrivate Konvention für eine oder mehrere Rollen.
Validierung: Nicht automatisch mit roles gleichsetzen; pro Issuer abbilden.
tenantPrivate Konvention für Tenant- oder Organisationsrouting.
Validierung: Tenant allein begründet kein Issuer-Vertrauen; mit authentifiziertem Kontext abgleichen.
org_idGängige Organisationskennung in SaaS-Autorisierungsmodellen.
Validierung: Als issuer-spezifischen Wert behandeln und Resource Membership separat erzwingen.
token_useAnbieter-Konvention zur Unterscheidung von Access- und Identity-Token.
Validierung: Nur nach offizieller Issuer-Dokumentation verwenden; Standard-typ/profile bevorzugen.