Zum Inhalt springen
ecdsa.com

JWKS (JSON Web Key Set)

Ein JSON-Objekt mit öffentlichen JWKs im Array keys, meist unter der jwks_uri des Ausstellers, damit die Relying Party Tokens prüft und der Rotation folgt.
Auch geschrieben alsJWK Setjwks_uriJSON Web Key Setjwks.json

OpenID Connect Discovery (/.well-known/openid-configuration) und die Metadaten von OAuth-Autorisierungsservern (RFC 8414) veröffentlichen die URL als jwks_uri; der Schlüsselsatz enthält jeden Schlüssel, der aktuell für die Prüfung gültig ist, jeweils mit einem kid. Verifizierer cachen den Schlüsselsatz, wählen den Schlüssel, dessen kid zum Header des Tokens passt, prüfen, ob kty und alg des Schlüssels zum erwarteten Algorithmus passen, und laden den Satz bei einem unbekannten kid neu, mit einem Rate Limit.

Bei der Rotation wird der neue Schlüssel aufgenommen, bevor mit ihm signiert wird, und der alte erst entfernt, wenn alle mit ihm signierten Tokens abgelaufen sind. Typische Fehler: versehentlich veröffentlichte private Felder (d), doppelte Werte für kid, Schlüssel ohne alg, die eine nachlässige Bibliothek mit dem falschen Algorithmus verwendet, und Caches, die sich nie aktualisieren. Der JWKS-Checker prüft einen live erreichbaren Endpunkt auf diese Probleme.

Standards und Quellen

Alle Begriffe