Propriétés de l’ensemble de clés Web JSON - Auth0 Docs

Voici un exemple de l’ensemble de clés Web JSON (JWKS) utilisé par un tenant d’exemple, contenant une seule clé Web JSON (JWK) :

{
"keys": [
  {
    "alg": "RS256",
    "kty": "RSA",
    "use": "sig",
    "x5c": [
      "MIIC+DCCAeCgAwIBAgIJBIGjYW6hFpn2MA0GCSqGSIb3DQEBBQUAMCMxITAfBgNVBAMTGGN1c3RvbWVyLWRlbW9zLmF1dGgwLmNvbTAeFw0xNjExMjIyMjIyMDVaFw0zMDA4MDEyMjIyMDVaMCMxITAfBgNVBAMTGGN1c3RvbWVyLWRlbW9zLmF1dGgwLmNvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMnjZc5bm/eGIHq09N9HKHahM7Y31P0ul+A2wwP4lSpIwFrWHzxw88/7Dwk9QMc+orGXX95R6av4GF+Es/nG3uK45ooMVMa/hYCh0Mtx3gnSuoTavQEkLzCvSwTqVwzZ+5noukWVqJuMKNwjL77GNcPLY7Xy2/skMCT5bR8UoWaufooQvYq6SyPcRAU4BtdquZRiBT4U5f+4pwNTxSvey7ki50yc1tG49Per/0zA4O6Tlpv8x7Red6m1bCNHt7+Z5nSl3RX/QYyAEUX1a28VcYmR41Osy+o2OUCXYdUAphDaHo4/8rbKTJhlu8jEcc1KoMXAKjgaVZtG/v5ltx6AXY0CAwEAAaMvMC0wDAYDVR0TBAUwAwEB/zAdBgNVHQ4EFgQUQxFG602h1cG+pnyvJoy9pGJJoCswDQYJKoZIhvcNAQEFBQADggEBAGvtCbzGNBUJPLICth3mLsX0Z4z8T8iu4tyoiuAshP/Ry/ZBnFnXmhD8vwgMZ2lTgUWwlrvlgN+fAtYKnwFO2G3BOCFw96Nm8So9sjTda9CCZ3dhoH57F/hVMBB0K6xhklAc0b5ZxUpCIN92v/w+xZoz1XQBHe8ZbRHaP1HpRM4M7DJk2G5cgUCyu3UBvYS41sHvzrxQ3z7vIePRA4WF4bEkfX12gvny0RsPkrbVMXX1Rj9t6V7QXrbPYBAO+43JvDGYawxYVvLhz+BJ45x50GFQmHszfY3BR9TPK8xmMmQwtIvLu1PMttNCs7niCYkSiUv2sc2mlq1i3IashGkkgmo="
    ],
    "n": "yeNlzlub94YgerT030codqEztjfU_S6X4DbDA_iVKkjAWtYfPHDzz_sPCT1Axz6isZdf3lHpq_gYX4Sz-cbe4rjmigxUxr-FgKHQy3HeCdK6hNq9ASQvMK9LBOpXDNn7mei6RZWom4wo3CMvvsY1w8tjtfLb-yQwJPltHxShZq5-ihC9irpLI9xEBTgG12q5lGIFPhTl_7inA1PFK97LuSLnTJzW0bj096v_TMDg7pOWm_zHtF53qbVsI0e3v5nmdKXdFf9BjIARRfVrbxVxiZHjU6zL6jY5QJdh1QCmENoejj_ytspMmGW7yMRxzUqgxcAqOBpVm0b-_mW3HoBdjQ",
    "e": "AQAB",
    "kid": "NjVBRjY5MDlCMUIwNzU4RTA2QzZFMDQ4QzQ2MDAyQjVDNjk1RTM2Qg",
    "x5t": "NjVBRjY5MDlCMUIwNzU4RTA2QzZFMDQ4QzQ2MDAyQjVDNjk1RTM2Qg"
  }
]}

Chaque propriété de la clé est définie par la spécification JWK RFC 7517 Section 4 ou, pour les propriétés propres à un algorithme, par la RFC 7518.

Nom de la propriété	Description
`alg`	L’algorithme cryptographique précis utilisé avec la clé. Il s’agit d’un paramètre facultatif. Par défaut, Auth0 inclut dans l’ensemble de clés Web JSON (JWKS) l’algorithme de signature défini au niveau du tenant, puis le publie. Pour permettre d’utiliser les clés avec plusieurs algorithmes plutôt qu’avec un seul, par ex. RS256, désactivez la bascule Include Signing Algorithms in JSON Web Key Set dans les paramètres Advanced du tenant dans Dashboard. Cela supprime le paramètre `alg` et oblige les consommateurs du JWKS à interpréter les algorithmes de signature selon les besoins.
`kty`	La famille d’algorithmes cryptographiques utilisée avec la clé.
`use`	L’usage prévu de la clé; `sig` représente la signature.
`x5c`	La chaîne de certificats x.509. La première entrée du tableau est le certificat à utiliser pour la vérification du token; les autres certificats peuvent servir à vérifier ce premier certificat.
`n`	Le module de la clé publique RSA.
`e`	L’exposant de la clé publique RSA.
`kid`	L’identifiant unique de la clé.
`x5t`	L’empreinte numérique du certificat x.509 (empreinte SHA-1).

Auth0 prend uniquement en charge HMAC et RSA; il ne prend actuellement pas en charge le chiffrement à courbe elliptique (ECDSA).

Pour voir un exemple qui utilise JWKS pour vérifier la signature d’un , consultez Navigating RS256 and JWKS (utilise Node.js), ou consultez nos Quickstarts Backend/API.

En savoir plus