Visionneuse JWKS et inspecteur de JWK
Collez un jeu de clés JSON Web Key Set ou un JWK isolé pour afficher d’un coup d’œil le kid, le type, l’algorithme, la taille et l’empreinte RFC 7638 de chaque clé. L’outil signale les éléments privés, les kid manquants ou en double et les clés RSA faibles, puis exporte les clés publiques en PEM, dans votre navigateur.
Fonctionnement technique
Un JSON Web Key Set (RFC 7517) est un objet JSON contenant un tableau "keys" qui publie les clés publiques utilisées par un fournisseur d’identité pour signer ses jetons, en général à l’adresse /.well-known/jwks.json. Chaque JWK décrit une clé par des membres comme kty (type), kid (identifiant), alg et use, ainsi que ses paramètres : n et e pour RSA, crv, x et y pour EC, ou x pour OKP.
Quand votre API reçoit un JWT, elle lit le kid dans l’en-tête, retrouve la clé correspondante dans le jeu et vérifie la signature avec elle. C’est ce qui simplifie la rotation : le fournisseur ajoute une nouvelle clé sous un nouveau kid, signe avec elle et laisse l’ancienne publiée jusqu’à l’expiration des anciens jetons.
Cette visionneuse analyse le JSON collé, liste chaque clé, calcule l’empreinte RFC 7638 et indique la vraie taille du modulo RSA ou la courbe EC. Elle signale les éléments privés, les clés oct symétriques, les kid manquants ou en double, les clés RSA faibles et les valeurs alg ou use incohérentes. Elle ne télécharge aucune URL : vous collez le contenu et tout reste dans votre navigateur.
Guide pas à pas avec exemple réel
Auditez un jeu de clés avant de le publier ou de lui faire confiance :
1. Coller votre JWKS
Collez un jeu complet, un JWK isolé ou un tableau de clés. Le bouton d’exemple montre le format. Jusqu’à 100 clés sont acceptées.
2. Lire chaque carte de clé
Vérifiez kid, kty, alg et use, puis la taille RSA en bits ou la courbe EC. L’empreinte donne à chaque clé un identifiant stable, comparable entre systèmes.
3. Corriger les alertes
Les erreurs rouges signalent une clé privée ou symétrique dans le jeu. Les avertissements orange concernent les kid manquants ou en double, le RSA faible et les algorithmes incohérents.
4. Exporter les clés publiques
Copiez une clé publique RSA ou EC au format SPKI PEM pour les bibliothèques qui ne lisent pas le JWK. Les clés privées ne sont jamais exportées.
Exemple : empreinte RFC 7638 section 3.1
{"e":"AQAB","kty":"RSA","n":"0vx7agoebGcQSuuPiLJXZptN9nndrQmbXEps2aiAFbWhM78LhWx4cbbfAAtVT86zwu1RK7aPFFxuhDR1L6tSoc_BJECPebWKRXjBZCiFV4n3oknjhMstn64tZ_2W-5JsGY4Hc5n9yBXArwl93lqt7_RN5w6Cf0h4QyQ5v-65YGjQR0_FDW2QvzqY368QQMicAtaSqzs8KJZgnYb9c7d0zgdAZHzu6qMQvRL5hajrn1n91CbOpbISD08qNLyrdkt-bFTWhAI4vMQFh6WeZu0fM4lFd2NcRwr3XPksINHaQ-G_xBniIqbw0Ls1jF44-csFCur-kEgU8awapJzKnqDKgw"}NzbLsXh8uDCcd-6MNwXF4W_7noWXFZAfHkxZsRGC9XsLa clé de 2048 bits de la RFC donne exactement cette valeur de 43 caractères. Les membres sont triés par ordre alphabétique, sans espace : toute implémentation correcte obtient la même empreinte.
Erreurs fréquentes et notes de sécurité
Publier un JWK privé
Les membres d, p et q sont privés. S’ils apparaissent dans jwks.json, n’importe qui peut forger des jetons. Ne publiez que les paramètres publics.
Réutiliser ou omettre le kid
Sans kid unique, le vérificateur doit essayer chaque clé et la rotation devient hasardeuse. Donnez à chaque clé un kid distinct, idéalement son empreinte.
Mettre une clé symétrique dans un jeu public
Un kty oct contient un secret partagé dans le membre k. Un JWKS public ne doit jamais l’inclure ; transmettez les secrets HMAC par un canal privé.
Faire confiance à l’alg du jeton
Imposez l’algorithme attendu pour chaque clé. Laisser l’en-tête décider permet la confusion d’algorithme, par exemple HS256 avec une clé RSA publique.
Types de clés JWK et membres de l’empreinte
| kty | Membres de l’empreinte | Alg courants | Publiable dans un JWKS |
|---|---|---|---|
| RSA | e, kty, n | RS256, PS256 | Oui, parties publiques |
| EC | crv, kty, x, y | ES256, ES384, ES512 | Oui, parties publiques |
| OKP | crv, kty, x | EdDSA | Oui, parties publiques |
| oct | k, kty | HS256, HS384, HS512 | Jamais |
Extraits de code (Node.js, Python, Java)
Vérifiez les jetons à partir d’un JWKS dans votre 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);
}
}
}Questions fréquentes
Quelle différence entre un JWK et un JWKS ?
Un JWK est une clé unique écrite en JSON. Un JWKS est un objet avec un tableau keys contenant un ou plusieurs JWK, selon la RFC 7517.
Qu’est-ce qu’une empreinte JWK et à quoi sert-elle ?
La RFC 7638 la définit comme le hachage SHA-256 des membres requis en JSON canonique, encodé en Base64URL. C’est un identifiant stable, pratique comme kid.
Pourquoi l’outil alerte-t-il sur les membres privés ?
Les paramètres d, p, q, dp, dq et qi sont privés. Un JWKS publié qui les expose permet à n’importe qui de signer des jetons acceptés par votre API.
L’outil peut-il télécharger mon jwks.json depuis une URL ?
Non. Il ne lit que le contenu collé et ne contacte jamais votre serveur. Ouvrez l’URL dans un onglet et copiez le JSON.
Quelle taille pour une clé RSA dans un JWKS ?
Au moins 2048 bits. L’outil mesure la vraie longueur du modulo à partir de n et avertit en dessous, car des clés plus courtes sont jugées faibles.
Comment faire pivoter les clés d’un JWKS ?
Ajoutez la nouvelle clé sous un nouveau kid, commencez à signer avec elle et gardez l’ancienne publiée jusqu’à l’expiration de tous les jetons qu’elle a signés. Retirez-la ensuite.
Outils associés
À propos de l’auteur
Avada Labs développe des outils gratuits pour développeurs, dont ce site, fort de six ans d’expérience en développement web et outils en ligne. Les projets et le code source sont disponibles sur GitHub.