La génération d'un JWT conforme aux standards en sérialisation compacte JWS (RFC 7515 section 3.1) transforme un en-tête JOSE, un ensemble de claims JSON et une clé secrète symétrique en une chaîne à trois segments formatée sous la forme <header>.<payload>.<signature>.
1. Construire l'En-tête JOSE et le Payload de Claims API
Commencez par un en-tête protégé HS256 et un payload JSON combinant des claims enregistrés RFC 7519 (iss, sub, aud, iat, exp) avec des claims applicatifs personnalisés (role) :
{
"alg": "HS256",
"typ": "JWT"
}
{
"iss": "https://auth.example.com",
"sub": "usr_9481",
"aud": "api.example.com",
"iat": 1767225600,
"exp": 1767229200,
"role": "admin"
}
Ici, 1767225600 représente 2026-01-01T00:00:00Z et 1767229200 représente 2026-01-01T01:00:00Z (une durée de vie de jeton d'une heure).
2. Construire l'Entrée de Signature Base64URL sans Padding
Chaque objet JSON est minifié en octets UTF-8 sans espaces superflus, encodé en Base64URL (alphabet - et _, padding = supprimé) et joint par un point ASCII (.) :
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJodHRwczovL2F1dGguZXhhbXBsZS5jb20iLCJzdWIiOiJ1c3JfOTQ4MSIsImF1ZCI6ImFwaS5leGFtcGxlLmNvbSIsImlhdCI6MTc2NzIyNTYwMCwiZXhwIjoxNzY3MjI5MjAwLCJyb2xlIjoiYWRtaW4ifQ
3. Vecteur de Signature HMAC-SHA256 Reproductible
Web Crypto importe les octets de votre secret via crypto.subtle.importKey("raw", secretBytes, { name: "HMAC", hash: "SHA-256" }, false, ["sign"]) et signe les octets ASCII exacts <base64url-header>.<base64url-payload>. Vous pouvez vérifier la parité déterministe entre OpenSSL, le module crypto de Node.js, PyJWT en Python et ce générateur en utilisant le vecteur de test canonique HS256 avec le secret UTF-8 your-256-bit-secret :
{
"sub": "1234567890",
"name": "John Doe",
"iat": 1516239022
}
La signature de l'en-tête {"alg":"HS256","typ":"JWT"} et du payload ci-dessus avec your-256-bit-secret produit toujours exactement ce jeton de 147 caractères, prêt pour un en-tête HTTP Authorization: Bearer <token> ou une vérification croisée dans le Décodeur et Inspecteur JWT :
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c