Passa al contenuto principale

5. JWK Set Format (Formato JWK Set)

Un JWK Set è un oggetto JSON che rappresenta un insieme di JWK. L'oggetto JSON deve (MUST) avere un membro « keys », il cui valore è un array di JWK. Questo oggetto JSON può (MAY) contenere spazi bianchi e/o interruzioni di riga.

I nomi dei membri all'interno di un JWK Set devono (MUST) essere unici; i parser di JWK Set devono (MUST) o rifiutare i JWK Set con nomi di membri duplicati o utilizzare un parser JSON che restituisce solo l'ultimo nome di membro duplicato lessicalmente, come specificato nella sezione 15.12 (« The JSON Object ») di ECMAScript 5.1 [ECMAScript].

Membri aggiuntivi possono essere presenti nel JWK Set; se non compresi dalle implementazioni che li incontrano, devono (MUST) essere ignorati. I parametri per rappresentare proprietà aggiuntive dei JWK Set dovrebbero (SHOULD) essere registrati nel registro IANA « JSON Web Key Set Parameters » stabilito dalla sezione 8.4 o essere un valore che contiene un nome resistente alle collisioni (Collision-Resistant Name).

Le implementazioni dovrebbero (SHOULD) ignorare i JWK all'interno di un JWK Set che utilizzano valori « kty » (key type, tipo di chiave) che non comprendono, che mancano di membri richiesti o per i quali i valori sono al di fuori degli intervalli supportati.

5.1. Parametro "keys"

Il valore del parametro « keys » è un array di valori JWK. Per impostazione predefinita, l'ordine dei valori JWK nell'array non implica un ordine di preferenza tra di essi, sebbene le applicazioni dei JWK Set possano scegliere di assegnare un significato all'ordine per i loro scopi, se desiderato.