Audit JWKS local

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

JSON canonique de la clé publique RSA (e, kty, n):{"e":"AQAB","kty":"RSA","n":"0vx7agoebGcQSuuPiLJXZptN9nndrQmbXEps2aiAFbWhM78LhWx4cbbfAAtVT86zwu1RK7aPFFxuhDR1L6tSoc_BJECPebWKRXjBZCiFV4n3oknjhMstn64tZ_2W-5JsGY4Hc5n9yBXArwl93lqt7_RN5w6Cf0h4QyQ5v-65YGjQR0_FDW2QvzqY368QQMicAtaSqzs8KJZgnYb9c7d0zgdAZHzu6qMQvRL5hajrn1n91CbOpbISD08qNLyrdkt-bFTWhAI4vMQFh6WeZu0fM4lFd2NcRwr3XPksINHaQ-G_xBniIqbw0Ls1jF44-csFCur-kEgU8awapJzKnqDKgw"}
Empreinte SHA-256 (Base64URL):NzbLsXh8uDCcd-6MNwXF4W_7noWXFZAfHkxZsRGC9Xs

La 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

ktyMembres de l’empreinteAlg courantsPubliable dans un JWKS
RSAe, kty, nRS256, PS256Oui, parties publiques
ECcrv, kty, x, yES256, ES384, ES512Oui, parties publiques
OKPcrv, kty, xEdDSAOui, parties publiques
octk, ktyHS256, HS384, HS512Jamais

Extraits de code (Node.js, Python, Java)

Vérifiez les jetons à partir d’un JWKS dans votre 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);
    }
  }
}

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.

À 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.

Visionneuse JWKS et empreinte JWK – Analyser les clés