jsonwebtoken (Node.js)

Les faits et les vérifications qui les fondent

Rien de ce qui suit n’est copié d’une documentation. La vérification content/libraries/verify/jsonwebtoken/run.sh a exécuté jsonwebtoken (Node.js) 9.0.3 sur Node.js 24.22.0 dans l’image de conteneur node:24.22.0-bookworm-slim le 20 octobre 2026 ; la page doit correspondre à ce que la vérification a affiché, et chaque fait cite les lignes en question.

• Algorithmes JWS

  HS256HS384HS512RS256RS384RS512PS256PS384PS512ES256ES384ES512

  Signature et vérification réussies lors des essais avec HS256/384/512, RS256/384/512, PS256/384/512 et ES256/384/512. EdDSA, Ed25519, Ed448, ES256K et ML-DSA ont été refusés à la signature.

  Relevé par la vérification

  fact jws-algorithms = HS256, HS384, HS512, RS256, RS384, RS512, PS256, PS384, PS512, ES256, ES384, ES512
  evidence jws-algorithms: ES256K: sign throws Error: "algorithm" must be a valid string enum value
  evidence jws-algorithms: EdDSA: sign throws Error: "algorithm" must be a valid string enum value
  evidence jws-algorithms: Ed25519: sign throws Error: "algorithm" must be a valid string enum value
  evidence jws-algorithms: Ed448: sign throws Error: "algorithm" must be a valid string enum value
  evidence jws-algorithms: ML-DSA-44: sign throws Error: "algorithm" must be a valid string enum value

• Encodage des signatures ES256

  raw

  Dans le jeton, les signatures ES256 font 64 octets en r‖s brut, comme l’exige la RFC 7518 ; la bibliothèque les convertit à partir du DER que produit node:crypto.

  Relevé par la vérification

  fact jws-ecdsa-encoding = raw

• Signature DER dans un JWS

  rejected

  Un jeton dont la signature ES256 a été réencodée en DER échoue avec "ES256" signatures must be "64" bytes, saw "72" (le nombre est la longueur du bloc DER).

  Relevé par la vérification

  fact jws-der-signature = rejected
  evidence jws-der-signature: TypeError: "ES256" signatures must be "64" bytes, saw "72"

• Liste d’algorithmes autorisés

  from-key

  Sans algorithms, la vérification n’autorise que les algorithmes adaptés à la clé : un jeton HS256 a été vérifié avec un secret partagé, un jeton ES256 avec une clé publique EC, et un jeton RS256 présenté à une clé EC a échoué avec invalid algorithm.

  Relevé par la vérification

  fact jwt-algorithm-allowlist = from-key
  evidence jwt-algorithm-allowlist: RS256 token against an EC key: JsonWebTokenError: invalid algorithm

• Jetons non signés (alg none)

  opt-in

  Un jeton non signé est refusé avec jwt signature is required dès qu’une clé est fournie ; il n’est vérifié que si algorithms contient none et que l’argument de clé est vide.

  Relevé par la vérification

  fact jwt-alg-none = opt-in
  evidence jwt-alg-none: with a key: JsonWebTokenError: jwt signature is required
  evidence jwt-alg-none: algorithms ["none"] and no key: verified

• Clé publique utilisée comme secret HMAC

  rejected

  Un jeton HS256 dont la clé HMAC est le texte PEM de la clé publique a été refusé aussi bien sans liste d’algorithmes (invalid algorithm) qu’avec algorithms: ["HS256"] (secretOrPublicKey must be a symmetric key when using HS256).

  Relevé par la vérification

  fact jwt-hmac-public-key = rejected
  evidence jwt-hmac-public-key: no list: JsonWebTokenError: invalid algorithm
  evidence jwt-hmac-public-key: algorithms ["HS256"]: JsonWebTokenError: secretOrPublicKey must be a symmetric key when using HS256

• Courbe vérifiée par rapport à alg

  enforced

  Signer en ES256 avec une clé P-384 lève "alg" parameter "ES256" requires curve "prime256v1". – ES256, ES384 et ES512 sont liés à P-256, P-384 et P-521.

  Relevé par la vérification

  fact jwt-ecdsa-curve-check = enforced
  evidence jwt-ecdsa-curve-check: Error: "alg" parameter "ES256" requires curve "prime256v1".

• Décalage d’horloge toléré par défaut

  0s

  Aucune marge de tolérance par défaut : un jeton expiré depuis trois secondes a été rejeté. Définissez clockTolerance, en secondes, pour tolérer une dérive d’horloge.

  Relevé par la vérification

  fact jwt-clock-skew = 0s

• Claim d’expiration obligatoire

  no

  Un jeton sans claim exp a été vérifié avec succès ; l’expiration n’est contrôlée que si le claim est présent ou si maxAge est défini.

  Relevé par la vérification

  fact jwt-exp-required = no

Utilisation

import { generateKeyPairSync } from "node:crypto";
import jwt from "jsonwebtoken";

const { privateKey, publicKey } = generateKeyPairSync("ec", { namedCurve: "P-256" });

const token = jwt.sign({ sub: "user-42" }, privateKey, {
  algorithm: "ES256",
  expiresIn: "10m",
  issuer: "https://auth.example.com",
  audience: "api",
});

// Pin the algorithm, issuer and audience instead of trusting the token header.
const claims = jwt.verify(token, publicKey, {
  algorithms: ["ES256"],
  issuer: "https://auth.example.com",
  audience: "api",
});

console.log("sub:", claims.sub);