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
{"e":"AQAB","kty":"RSA","n":"0vx7agoebGcQSuuPiLJXZptN9nndrQmbXEps2aiAFbWhM78LhWx4cbbfAAtVT86zwu1RK7aPFFxuhDR1L6tSoc_BJECPebWKRXjBZCiFV4n3oknjhMstn64tZ_2W-5JsGY4Hc5n9yBXArwl93lqt7_RN5w6Cf0h4QyQ5v-65YGjQR0_FDW2QvzqY368QQMicAtaSqzs8KJZgnYb9c7d0zgdAZHzu6qMQvRL5hajrn1n91CbOpbISD08qNLyrdkt-bFTWhAI4vMQFh6WeZu0fM4lFd2NcRwr3XPksINHaQ-G_xBniIqbw0Ls1jF44-csFCur-kEgU8awapJzKnqDKgw"}NzbLsXh8uDCcd-6MNwXF4W_7noWXFZAfHkxZsRGC9XsLa 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
| kty | Miembros de la huella | Alg habituales | Seguro en un JWKS público |
|---|---|---|---|
| RSA | e, kty, n | RS256, PS256 | Sí, solo partes públicas |
| EC | crv, kty, x, y | ES256, ES384, ES512 | Sí, solo partes públicas |
| OKP | crv, kty, x | EdDSA | Sí, solo partes públicas |
| oct | k, kty | HS256, HS384, HS512 | Nunca |
Ejemplos de código (Node.js, Python, Java)
Verifique tokens contra un JWKS en su backend:
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');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",
)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.
Herramientas relacionadas
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.