Vérification WebCrypto

Vérificateur de signature JWT en ligne

Contrôlez la signature cryptographique des jetons JWT (HS256/384/512, RS256/384/512, PS256/384/512 et ES256/384/512) ainsi que les dates exp et nbf directement dans votre navigateur via WebCrypto. Aucune clé secrète ni jeton n’est transmis sur le réseau.

Fonctionnement technique

Un jeton JWS compact associe trois segments Base64URL séparés par des points : l’en-tête JOSE, la charge utile JSON et la signature calculée sur la chaîne ASCII en-tête.payload. Contrairement à un simple décodeur, la vérification cryptographique contrôle mathématiquement cette empreinte grâce au moteur natif WebCrypto (crypto.subtle) directement dans la mémoire de votre navigateur, sans transmettre ni jetons ni clés.

Pour les algorithmes symétriques HMAC (HS256, HS384, HS512), l’outil décode votre secret en texte UTF-8, hexadécimal, Base64 ou Base64URL et signale immédiatement toute clé inférieure aux seuils de la RFC 7518 section 3.2. Pour les jetons asymétriques, il importe des clés publiques PEM SPKI ou JWK/JWKS afin de valider RSASSA-PKCS1-v1_5, RSA-PSS ou les signatures ECDSA brutes r||s (ES256, ES384, ES512), tout en rejetant alg: "none" et en précisant les limites natives de WebCrypto pour EdDSA et ES256K.

Guide pas à pas avec exemple réel

Suivez ces quatre étapes pour valider à la fois la signature cryptographique et les claims temporels d’un jeton JWT en local.

1. Coller le jeton JWT compact

Saisissez les trois segments séparés par des points dans la zone dédiée, ou chargez un vecteur officiel de la RFC 7515 pour tester immédiatement l’outil.

2. Fixer l’algorithme attendu

Laissez la détection automatique pour un diagnostic rapide ou verrouillez un algorithme précis (RS256, ES256) pour reproduire une liste blanche serveur stricte.

3. Fournir le secret HMAC ou la clé publique

Choisissez le bon encodage pour un secret HMAC, ou collez une clé publique PEM SPKI, un objet JWK ou un jeu JWKS pour les signatures asymétriques.

4. Contrôler signature et tolérance d’horloge

Ajustez le délai de tolérance en secondes si nécessaire, puis vérifiez le statut mathématique de la signature et la validité des dates exp, nbf et iat.

Exemple concret : Vecteur RFC 7515 Annexe A.1 (HS256)

Jeton et secret JWK k (Base64URL):Jeton : eyJ0eXAiOiJKV1QiLA0KICJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJqb2UiLA0KICJleHAiOjEzMDA4MTkzODAsDQogImh0dHA6Ly9leGFtcGxlLmNvbS9pc19yb290Ijp0cnVlfQ.dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk | Secret : AyM1SysPpbyDfgZld3umj1qzKObwVMkoqQ-EstJQLr_T-1qS0gZH75aKtMN3Yj0iPS4hcgUuTwjAzZr1Z9CAow
Résultat observé:Signature VALIDE (HS256, empreinte 32 octets, clé 512 bits) · exp=1300819380 (2011-03-22T18:43:00Z, expiré) · claims iss="joe", is_root=true.

La signature reste mathématiquement exacte même après l’expiration du jeton, ce qui aide à distinguer un problème d’horloge d’une corruption de clé.

Erreurs fréquentes et notes de sécurité

Faire confiance aveuglément à l’en-tête « alg »

Sur un serveur, accepter l’algorithme lu dans le jeton expose à l’attaque par confusion d’algorithme (par exemple signer en HS256 avec la clé publique RSA). Imposez toujours un algorithme fixe.

Autoriser l’algorithme « none » en production

Un jeton portant alg: "none" ne contient aucune signature vérifiable. Toute API sécurisée doit le refuser systématiquement, comme le fait cet outil par défaut.

Utiliser des secrets HMAC trop courts

La RFC 7518 exige au moins 256 bits pour HS256, 384 bits pour HS384 et 512 bits pour HS512. Un mot de passe court affaiblit gravement la résistance aux attaques hors ligne.

Exposer une clé privée lors d’une vérification

La validation d’une signature asymétrique ne nécessite jamais la clé privée. Ne transmettez et ne collez que la clé publique SPKI ou le JWK public.

Comparatif des algorithmes de signature JWT

AlgorithmeType de cléSignatureUsage recommandé
HS256 / HS384 / HS512Secret partagé symétriqueMAC HMAC-SHA (32 à 64 o)Architecture monolithe ou microservices internes
RS256 / RS384 / RS512RSA asymétrique (PKCS#1)Signature taille du moduleCompatibilité étendue et fournisseurs OIDC
PS256 / PS384 / PS512RSA-PSS asymétriqueRemplissage probabilisteSystèmes modernes exigeant PSS
ES256 / ES384 / ES512ECDSA asymétrique (P-256..521)Brut IEEE P1363 r||sJetons compacts pour mobiles et passerelles API

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

Exemples serveur avec épinglage strict d’algorithme pour reproduire la vérification en production :

Node.js (TypeScript)
import { createHmac, timingSafeEqual } from 'node:crypto';

export function verifyHs256(token: string, secret: Buffer) {
  if (secret.length < 32) throw new Error('Key < 256 bits');
  const [hdr, pay, sig] = token.split('.');
  const { alg } = JSON.parse(Buffer.from(hdr, 'base64url').toString());
  if (alg !== 'HS256') throw new Error('Invalid alg');
  const expected = createHmac('sha256', secret).update(`${hdr}.${pay}`).digest();
  const actual = Buffer.from(sig, 'base64url');
  if (expected.length !== actual.length || !timingSafeEqual(expected, actual)) throw new Error('Bad signature');
  return JSON.parse(Buffer.from(pay, 'base64url').toString());
}
Python
import jwt

def verify_rs256(token: str, public_pem: str, aud: str) -> dict:
    return jwt.decode(
        token, public_pem, algorithms=["RS256"],
        audience=aud, leeway=30, options={"require": ["exp", "sub"]},
    )
Java
DecodedJWT jwt = JWT.require(Algorithm.ECDSA256(ecPublicKey, null))
    .withIssuer("https://auth.example.com")
    .acceptLeeway(15)
    .build()
    .verify(token);

Questions fréquentes

Quelle différence y a-t-il entre décoder un JWT et vérifier sa signature ?

Le décodage se contente de lire le Base64URL pour afficher le JSON. La vérification recalcule ou contrôle la signature cryptographique avec une clé de confiance pour prouver l’intégrité du jeton.

Pourquoi faut-il verrouiller l’algorithme attendu côté serveur ?

Sans liste blanche explicite, un attaquant peut modifier l’en-tête vers HS256 et tenter de forger un jeton avec votre clé publique RSA connue.

Pourquoi EdDSA et ES256K ne sont-ils pas vérifiés dans cet outil ?

Cet outil s’appuie uniquement sur WebCrypto natif (crypto.subtle) sans bibliothèque externe. Les navigateurs ne supportent pas standardement ES256K et le support d’EdDSA varie encore.

Pourquoi la signature est-elle valide alors que le jeton est marqué expiré ?

La signature prouve l’authenticité de l’émetteur au moment de la création, tandis que le contrôle du claim exp évalue si l’instant présent dépasse la durée de validité autorisée.

Puis-je coller directement un fichier JWKS complet ?

Oui. Si le champ kid est présent dans l’en-tête JWT, l’outil sélectionne automatiquement la clé correspondante dans le tableau keys du JWKS.

Mes secrets ou jetons de production sont-ils envoyés à un serveur ?

Non. Toute la vérification s’exécute localement dans votre navigateur via WebCrypto sans aucun appel réseau ni journalisation.

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

Vérificateur de signature JWT – HS256, RS256, ES256