Propiedades del conjunto de claves web JSON

Describe las propiedades disponibles en un conjunto de claves web JSON (JWKS).

A continuación, se muestra un ejemplo del conjunto de claves web JSON (JWKS) utilizado por un inquilino de ejemplo, que contiene una sola JSON Web Key (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"
  }
]}

Cada propiedad de la clave está definida por la especificación JWK RFC 7517 Section 4 o, en el caso de las propiedades específicas de un algoritmo, por RFC 7518.

Nombre de la propiedad	Descripción
alg	El algoritmo criptográfico específico que se usa con la clave. Este es un parámetro opcional. De forma predeterminada, Auth0 incluye en el conjunto de claves web JSON (JWKS) el algoritmo de firma definido a nivel del inquilino, que luego se publica. Para permitir que las claves se usen con varios algoritmos en lugar de con uno solo, por ejemplo, RS256, desactive Include Signing Algorithms in JSON Web Key Set en la Configuración avanzada del tenant del Dashboard. Esto elimina el parámetro alg y requiere que los consumidores del JWKS interpreten los algoritmos de firma según corresponda.
kty	La familia de algoritmos criptográficos que se usa con la clave.
use	El uso previsto de la clave; sig representa la firma.
x5c	La cadena de certificados x.509. La primera entrada del arreglo es el certificado que se usa para verificar el token; los demás certificados pueden usarse para verificar este primer certificado.
n	El módulo de la clave pública RSA.
e	El exponente de la clave pública RSA.
kid	El identificador único de la clave.
x5t	La huella digital del certificado x.509 (huella digital SHA-1).

Auth0 solo admite HMAC y RSA; actualmente no admite criptografía de curva elíptica (ECDSA).

Para ver un ejemplo que usa JWKS para verificar la firma de un JWT, consulte Navigating RS256 and JWKS (usa Node.js) o revise nuestros Quickstarts de Backend/API.

​

Más información

• Conjuntos de claves web JSON
• Cómo localizar conjuntos de claves web JSON
• Estructura del JSON Web Token