5. JWK Set Format (JWK Set Format)

Ein JWK Set ist ein JSON-Objekt, das eine Menge von JWKs darstellt. Das JSON-Objekt muss (MUST) ein „keys"-Mitglied haben, dessen Wert ein Array von JWKs ist. Dieses JSON-Objekt kann (MAY) Leerzeichen und/oder Zeilenumbrüche enthalten.

Die Mitgliedsnamen innerhalb eines JWK Sets müssen (MUST) eindeutig sein; JWK Set Parser müssen (MUST) entweder JWK Sets mit doppelten Mitgliedsnamen ablehnen oder einen JSON-Parser verwenden, der nur den lexikalisch letzten doppelten Mitgliedsnamen zurückgibt, wie in Abschnitt 15.12 („The JSON Object") von ECMAScript 5.1 [ECMAScript] spezifiziert.

Zusätzliche Mitglieder können im JWK Set vorhanden sein; wenn sie von Implementierungen, die auf sie stoßen, nicht verstanden werden, müssen (MUST) sie ignoriert werden. Parameter zur Darstellung zusätzlicher Eigenschaften von JWK Sets sollten (SHOULD) im IANA-Register „JSON Web Key Set Parameters", das durch Abschnitt 8.4 eingerichtet wurde, registriert werden oder ein Wert sein, der einen kollisionsresistenten Namen (Collision-Resistant Name) enthält.

Implementierungen sollten (SHOULD) JWKs innerhalb eines JWK Sets ignorieren, die „kty" (key type, Schlüsseltyp) Werte verwenden, die von ihnen nicht verstanden werden, denen erforderliche Mitglieder fehlen oder für die Werte außerhalb der unterstützten Bereiche liegen.

5.1. "keys" Parameter

Der Wert des „keys"-Parameters ist ein Array von JWK-Werten. Standardmäßig impliziert die Reihenfolge der JWK-Werte im Array keine Präferenzreihenfolge unter ihnen, obwohl Anwendungen von JWK Sets wählen können, der Reihenfolge für ihre Zwecke eine Bedeutung zuzuweisen, falls gewünscht.