Auditoría JWKS local

Visor JWKS e inspector de JWK

Pegue un JSON Web Key Set o un JWK individual para ver de un vistazo el kid, el tipo, el algoritmo, el tamaño y la huella RFC 7638 de cada clave. La herramienta avisa de material privado, kid ausentes o repetidos y claves RSA débiles, y exporta las claves públicas en PEM, todo dentro de su navegador.

Cómo funciona

Un JSON Web Key Set (RFC 7517) es un objeto JSON con un arreglo "keys" que publica las claves públicas con las que un proveedor de identidad firma sus tokens, normalmente en /.well-known/jwks.json. Cada JWK describe una clave con miembros como kty (tipo), kid (identificador), alg y use, además de sus parámetros: n y e en RSA, crv, x e y en EC, o x en OKP.

Cuando su API recibe un JWT, lee el kid del encabezado, busca la clave correspondiente en el conjunto y verifica la firma con ella. Eso facilita la rotación: el proveedor añade una clave nueva con otro kid, firma con ella y mantiene publicada la anterior hasta que caduquen los tokens antiguos.

Este visor analiza el JSON pegado, lista cada clave, calcula la huella RFC 7638 e indica el tamaño real del módulo RSA o la curva EC. Avisa de miembros privados, claves oct simétricas, kid ausentes o repetidos, claves RSA débiles y valores alg o use incoherentes. No descarga ninguna URL: usted pega el contenido y todo permanece en su navegador.

Guía paso a paso con ejemplo real

Audite un conjunto de claves antes de publicarlo o de fiarse de él:

1. Pegar su JWKS

Pegue un conjunto completo, un JWK individual o un arreglo de claves. El botón de ejemplo muestra el formato. Se aceptan hasta 100 claves.

2. Leer cada tarjeta de clave

Revise kid, kty, alg y use, y después el tamaño RSA en bits o la curva EC. La huella da a cada clave un identificador estable que puede comparar entre sistemas.

3. Corregir los avisos

Los errores en rojo indican material privado o una clave simétrica dentro del conjunto. Los avisos ámbar cubren kid ausentes o repetidos, RSA débil y algoritmos incoherentes.

4. Exportar claves públicas

Copie una clave pública RSA o EC como bloque PEM SPKI para bibliotecas que no leen JWK. Las claves privadas nunca se exportan.

Ejemplo: huella RFC 7638 sección 3.1

JSON canónico de la clave pública RSA (e, kty, n):{"e":"AQAB","kty":"RSA","n":"0vx7agoebGcQSuuPiLJXZptN9nndrQmbXEps2aiAFbWhM78LhWx4cbbfAAtVT86zwu1RK7aPFFxuhDR1L6tSoc_BJECPebWKRXjBZCiFV4n3oknjhMstn64tZ_2W-5JsGY4Hc5n9yBXArwl93lqt7_RN5w6Cf0h4QyQ5v-65YGjQR0_FDW2QvzqY368QQMicAtaSqzs8KJZgnYb9c7d0zgdAZHzu6qMQvRL5hajrn1n91CbOpbISD08qNLyrdkt-bFTWhAI4vMQFh6WeZu0fM4lFd2NcRwr3XPksINHaQ-G_xBniIqbw0Ls1jF44-csFCur-kEgU8awapJzKnqDKgw"}
Huella SHA-256 (Base64URL):NzbLsXh8uDCcd-6MNwXF4W_7noWXFZAfHkxZsRGC9Xs

La clave de 2048 bits de la RFC produce exactamente este valor de 43 caracteres. Los miembros se ordenan alfabéticamente y sin espacios, por lo que cualquier implementación correcta obtiene la misma huella.

Errores comunes y notas de seguridad

Publicar un JWK privado

Los miembros d, p y q son privados. Si aparecen en jwks.json, cualquiera puede falsificar tokens. Publique solo parámetros públicos.

Repetir u omitir el kid

Sin un kid único, el verificador debe probar todas las claves y la rotación se vuelve incierta. Dé a cada clave un kid distinto, idealmente su huella.

Incluir claves simétricas en un conjunto público

Un kty oct guarda un secreto compartido en el miembro k. Un JWKS público nunca debe incluirlo; comparta los secretos HMAC por un canal privado.

Fiarse del alg del token

Fije el algoritmo esperado para cada clave. Dejar decidir al encabezado permite la confusión de algoritmos, por ejemplo HS256 comprobado con una clave pública RSA.

Tipos de clave JWK y miembros de la huella

ktyMiembros de la huellaAlg habitualesSeguro en un JWKS público
RSAe, kty, nRS256, PS256Sí, solo partes públicas
ECcrv, kty, x, yES256, ES384, ES512Sí, solo partes públicas
OKPcrv, kty, xEdDSASí, solo partes públicas
octk, ktyHS256, HS384, HS512Nunca

Ejemplos de código (Node.js, Python, Java)

Verifique tokens contra un JWKS en su backend:

Node.js (TypeScript)
import { createRemoteJWKSet, jwtVerify, calculateJwkThumbprint } from 'jose';
import type { JWK } from 'jose';

const JWKS = createRemoteJWKSet(new URL('https://auth.example.com/.well-known/jwks.json'));

export async function verify(token: string) {
  const { payload, protectedHeader } = await jwtVerify(token, JWKS, {
    issuer: 'https://auth.example.com',
    audience: 'my-api',
    algorithms: ['RS256'],
  });
  return { payload, kid: protectedHeader.kid };
}

export const thumbprint = (jwk: JWK) => calculateJwkThumbprint(jwk, 'sha256');
Python
import jwt  # PyJWT with the cryptography package
from jwt import PyJWKClient

client = PyJWKClient("https://auth.example.com/.well-known/jwks.json")

def verify(token: str) -> dict:
    signing_key = client.get_signing_key_from_jwt(token)
    return jwt.decode(
        token,
        signing_key.key,
        algorithms=["RS256"],
        audience="my-api",
        issuer="https://auth.example.com",
    )
Java
import com.nimbusds.jose.jwk.JWK;
import com.nimbusds.jose.jwk.JWKSet;
import com.nimbusds.jose.util.Base64URL;
import java.net.URL;

public class JwksInspect {
  public static void main(String[] args) throws Exception {
    JWKSet set = JWKSet.load(new URL("https://auth.example.com/.well-known/jwks.json"));
    for (JWK jwk : set.getKeys()) {
      Base64URL thumbprint = jwk.computeThumbprint();
      System.out.println(jwk.getKeyID() + " " + jwk.getKeyType() + " " + thumbprint);
    }
  }
}

Preguntas frecuentes

¿Qué diferencia hay entre JWK y JWKS?

Un JWK es una sola clave escrita en JSON. Un JWKS es un objeto con un arreglo keys que contiene uno o más JWK, según la RFC 7517.

¿Qué es una huella JWK y para qué sirve?

La RFC 7638 la define como el hash SHA-256 de los miembros requeridos en JSON canónico, codificado en Base64URL. Es un identificador estable, útil como kid.

¿Por qué avisa el visor de miembros privados?

Los parámetros d, p, q, dp, dq y qi son privados. Un JWKS publicado que los exponga permite a cualquiera firmar tokens que su API aceptará.

¿Puede esta herramienta descargar mi jwks.json desde una URL?

No. Solo lee contenido pegado, así que nunca contacta con su servidor y evita riesgos de CORS y de peticiones desde el servidor. Abra la URL en una pestaña y copie el JSON.

¿Qué tamaño debe tener una clave RSA en un JWKS?

Al menos 2048 bits. El visor mide la longitud real del módulo a partir de n y avisa por debajo, porque las claves más cortas se consideran débiles.

¿Cómo roto las claves de un JWKS?

Añada la clave nueva con otro kid, empiece a firmar con ella y mantenga publicada la anterior hasta que caduquen todos los tokens que firmó. Después retírela.

Acerca del autor

Avada Labs crea herramientas gratuitas para desarrolladores, incluido este sitio, con seis años de experiencia en desarrollo web y herramientas en línea. Los proyectos y el código fuente están en GitHub.

Visor JWKS y huella JWK – Inspeccionar conjuntos de claves