Elaborazione 100% Lato Client • Zero Registri di Rete • Esecuzione Immediata
Curious TechieToolbox Sviluppatori
JWT8 min di lettura•Italiano EditionEsecuzione 100% Lato Client

Cos’è un JWT? Architettura dei JSON Web Token (RFC 7519)

Autenticazione stateless, struttura a tre parti, codifica Base64URL, attacchi di algoritmo e verifica crittografica.

CT
Curious-Techie Engineering TeamAutore Verificato

Web Protocols & Security Architecture Research

Pubblicato:
•
Aggiornato:
•8 min di lettura
Specifica Ufficiale:RFC 7519(IETF)
Revisionato da Curious-Techie Architecture Peer Review Group
Domanda Principale • Risposta Tecnica Immediata

Cos’è un JWT? Architettura dei JSON Web Token (RFC 7519)

TL;DR — Punti Chiave di Ingegneria

  • Un JWT è composto da 3 parti separate da punti: Header, Payload e Firma.
  • Le informazioni sono codificate in Base64URL e possono essere lette da chiunque senza password.
  • Decodificare un JWT NON significa validarlo: la sicurezza risiede nella verifica della firma.
  • La vulnerabilità alg: "none" si verifica quando i server accettano token privi di firma.
  • L’architettura stateless rende necessaria una deny-list o un TTL breve per la revoca immediata.
// FONDAMENTI

Concetti Chiave e Architettura

Compact Serialization

Structure

String format structured as `header.payload.signature` optimized for HTTP Authorization headers and URL parameters.

Registered Claims

Claims

Standard predefined metadata fields (`iss` issuer, `sub` subject, `aud` audience, `exp` expiration, `iat` issued-at).

Symmetric Signing (HS256)

Signing

Both the identity provider and the API gateway share the identical secret key to sign and verify tokens.

Asymmetric Signing (RS256 / ES256)

PKI

Identity provider signs tokens with a private key; multiple microservices verify tokens using a public JWKS endpoint.

Stateless Verification

Scalability

Services verify authorization cryptographically using keys in memory without database lookups.

Domanda Secondaria • Flusso di Esecuzione

Come funziona Cos’è un JWT? Architettura dei JSON Web Token (RFC 7519)?

Risposta Diretta:

When an authentication server validates a user’s credentials, it constructs a JSON payload containing user identity and authorization claims. It serializes the header and payload as Base64URL strings, concatenates them with a dot, and feeds the resulting string into a cryptographic signing function along with a private secret or key. The resulting signature is appended. Downstream services verify the token by recomputing or validating the signature against the received header and payload.

1

Header Construction

Declare the signing algorithm (e.g. HS256) and type.

{"alg": "HS256", "typ": "JWT"}
2

Payload Construction

Populate registered claims (`exp`, `iat`) and domain-specific roles.

{"sub": "usr_9918", "role": "admin", "exp": 1799000000}
3

Base64URL Encoding

Convert JSON bytes into URL-safe strings without padding (= characters replaced).

header_b64 = base64url(header);
payload_b64 = base64url(payload);
4

Cryptographic Signature

Hash the concatenated header and payload with secret key.

sig = HMAC_SHA256(header_b64 + "." + payload_b64, secret);
5

Token Assembly

Join all 3 components with periods to form the final compact token string.

jwt = header_b64 + "." + payload_b64 + "." + base64url(sig);
6

Bearer Token Transmission

Client includes token in Authorization header for subsequent API requests.

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Esempi Tecnici • Implementazione

Come implementare Cos’è un JWT? Architettura dei JSON Web Token (RFC 7519) nella pratica?

Verifying a JWT Signature in Node.js (Crypto Native API)

javascript
import crypto from "crypto";

function verifyHS256(jwt, secret) {
  const [headerB64, payloadB64, signatureB64] = jwt.split(".");
  if (!headerB64 || !payloadB64 || !signatureB64) return false;

  const data = `${headerB64}.${payloadB64}`;
  const expectedSig = crypto
    .createHmac("sha256", secret)
    .update(data)
    .digest("base64url");

  // Constant-time comparison to prevent timing attacks
  return crypto.timingSafeEqual(
    Buffer.from(signatureB64),
    Buffer.from(expectedSig)
  );
}

Dettagli di Ingegneria: Native cryptographic verification using timing-safe buffer comparison to prevent side-channel timing attacks.

Decoding JWT Claims in Browser JavaScript (Client-Side Safe)

javascript
function parseJwtPayload(token) {
  const base64Url = token.split(".")[1];
  const base64 = base64Url.replace(/-/g, "+").replace(/_/g, "/");
  const jsonPayload = decodeURIComponent(
    atob(base64)
      .split("")
      .map((c) => "%" + ("00" + c.charCodeAt(0).toString(16)).slice(-2))
      .join("")
  );
  return JSON.parse(jsonPayload);
}

Dettagli di Ingegneria: Pure client-side parsing without third-party dependencies, properly handling Unicode UTF-8 character boundaries.

Architettura di Produzione • Casi Reali

Dove e perché si utilizza Cos’è un JWT? Architettura dei JSON Web Token (RFC 7519) in produzione?

Decentralized Microservices Architecture

API gateway receives user login, issues RS256 token; 50 downstream microservices independently verify claims.

Services download the gateway’s public JWKS (`/.well-known/jwks.json`) once and cache it, avoiding auth server query bottlenecks.

Mobile App API Authorization

iOS and Android native applications maintaining offline access tokens with refresh rotation.

Access token valid for 15 minutes; refresh token stored in OS Keychain used to request fresh JWTs silently.

Errori Comuni e Anti-pattern

Quali sono gli errori comuni con Cos’è un JWT? Architettura dei JSON Web Token (RFC 7519)?

Anti-Pattern: Treating JWT payload claims as encrypted private data

Impatto: Sensitive passwords, SSNs, or PII stored in payload are visible to anyone who intercepts the token.

Correzione Raccomandata: Remember that standard JWS tokens are signed, not encrypted. Use JWE (RFC 7516) or store only non-sensitive IDs in claims.

Anti-Pattern: Failing to validate the `alg` header (The "alg: none" Vulnerability)

Impatto: Attackers modify the header to `"alg": "none"`, strip the signature, and forge arbitrary admin permissions.

Correzione Raccomandata: Hardcode expected verification algorithms on the server (e.g. `algorithms: ["HS256"]`) and reject any `"alg": "none"`.

Anti-Pattern: Failing to validate expiration (`exp`) claim timestamps

Impatto: Stolen tokens remain valid perpetually, enabling indefinite account takeovers.

Correzione Raccomandata: Always mandate strict expiration checks against current UTC timestamp (`exp < Math.floor(Date.now() / 1000)`).

Modellazione delle Minacce • Vettori di Attacco

Quali sono i rischi e le implicazioni di sicurezza di Cos’è un JWT? Architettura dei JSON Web Token (RFC 7519)?

Algorithm Confusion Attack (HMAC vs RSA Key Confusion)

CVE-2015-9235 (Algorithm Confusion)

Vulnerabilità: Server expects RS256 with public key; attacker signs token using HMAC-SHA256 with the server’s public key as the symmetric secret.

Strategia di Mitigazione: Explicitly enforce the expected algorithm; never allow client header `alg` to dictate whether verification uses a public or symmetric key.

Weak Symmetric Secrets & Brute-Forcing

CWE-326 Inadequate Encryption Strength

Vulnerabilità: Using a weak HMAC secret (e.g. "secret123") allows attackers to brute-force the key offline using Hashcat at billions of guesses per second.

Strategia di Mitigazione: Generate cryptographically random secrets with at least 256 bits of entropy (32 random bytes from `/dev/urandom`).
Diagnostica • Risoluzione Causa Radice

Come diagnosticare e risolvere errori con Cos’è un JWT? Architettura dei JSON Web Token (RFC 7519)?

Sintomi e Indicazioni Cliniche: JsonWebTokenError: invalid signature

Analisi Tecnica della Causa Principale:
  • Secret key mismatch between issuer and validator
  • Payload mutated in transit
  • Trailing whitespace or padding corrupted Base64URL string
Soluzione Verificata in Produzione: Inspect token in Curious-Techie JWT Decoder; verify environment variable `JWT_SECRET` matches across both services.

Sintomi e Indicazioni Cliniche: TokenExpiredError: jwt expired

Analisi Tecnica della Causa Principale:
  • `exp` timestamp in the past
  • Server clock drift between issuer and verifier servers
Soluzione Verificata in Produzione: Configure small clock tolerance (`clockTolerance: 10` seconds) in verifier library; ensure NTP synchronization on servers.
Knowledge Base • Risposte Tecniche Dirette

Domande Frequenti su Cos’è un JWT? Architettura dei JSON Web Token (RFC 7519)

Q:Is the data inside a standard JWT encrypted?

Risposta Diretta:No. Standard JWTs (RFC 7519 JSON Web Signatures) are only signed and Base64URL-encoded, not encrypted. Anyone who intercepts the token can decode and view all payload claims in plaintext.

A signature guarantees integrity (that data was not tampered with) and authenticity (who created it), but provides zero confidentiality. If confidential payload data is required, JSON Web Encryption (JWE, RFC 7516) must be used.

Q:What is the difference between HS256 and RS256?

Risposta Diretta:HS256 is symmetric (both signer and verifier share one secret key). RS256 is asymmetric (the identity provider signs with a private key, and anyone can verify using the public key).

HS256 is ideal for monolithic apps where only one backend needs to verify the token. RS256 is preferred in microservices because worker services only need the public key and cannot forge their own tokens.

Q:How do you revoke a JWT before it expires?

Risposta Diretta:Because JWTs are stateless, instant revocation requires checking a centralized blacklist (e.g. in Redis) or keeping token lifetimes very short (e.g. 10 minutes) and revoking the refresh token.

Pure statelessness means the token is self-contained. To revoke immediately, architectures typically store a `jti` (JWT ID) blacklist in a low-latency Redis cache or invalidate the user’s token generation counter.

Sezione 12 • Utilità Interattive

Strumenti Correlati

Esecuzione 100% Lato Client

Companion Interactive Tool100% Client-Side Execution

Test & Verify with JWT Decoder

Decode and inspect JWT headers, payloads, and signatures securely.

Companion Interactive Tool100% Client-Side Execution

Test & Verify with JWT Security Inspector

Audit JWT vulnerabilities: none algorithm, weak signing, and claim flaws.

Companion Interactive Tool100% Client-Side Execution

Test & Verify with Base64 Encoder / Decoder

Encode and decode Base64 strings and UTF-8 text client-side.

Companion Interactive Tool100% Client-Side Execution

Test & Verify with Cryptographic Hash Generator

Generate SHA-256, SHA-384, SHA-512, SHA-1, and MD5 hashes locally.

Glossario

JWT
JSON Web Token: Compact URL-safe means of representing claims to be transferred between two parties.
Claim
A piece of information asserted about a subject, represented as a key-value pair in the JSON payload.
Base64URL
URL-safe Base64 encoding where + is replaced with -, / is replaced with _, and padding = is omitted.
JWKS
JSON Web Key Set: A JSON data structure representing a set of public cryptographic keys.
Authoritative Sourcing & Verification

References & Primary Sources

Every source below directly substantiates technical statements and protocol behaviors explained in Cos’è un JWT? Architettura dei JSON Web Token (RFC 7519). Curious-Techie prioritizes official Internet standards (IETF RFCs, W3C Recommendations, WHATWG specifications) and established security bodies (OWASP, NIST). Zero sponsored or secondary links.

  1. [1]IETFPrimary SpecificationRFC 7519 • Section 3 & 4
    Verified Primary Source
    Technical Claim Supported:

    Defines the compact, URL-safe format of JSON Web Tokens consisting of three Base64URL segments (Header, Payload, Signature) and registered claims (iss, sub, aud, exp, nbf, iat, jti).

    “A JWT is represented as the concatenation of the Encoded JWT Header, the Encoded JWT Claims Set, and the Encoded JWT Signature or Encoded JWT Encryption Data, with the parts being separated by period ('.') characters.”
  2. [2]IETFPrimary SpecificationRFC 7515 • Section 4 (Cryptographic Signatures)
    Verified Primary Source
    Technical Claim Supported:

    Defines digital signatures and MAC algorithms (HS256, RS256, ES256) used to secure JWT integrity and verify token authorship.

  3. [3]IETFAuthoritative Security StandardRFC 8725 • Security Considerations § 3
    Verified Primary Source
    Technical Claim Supported:

    Mandates explicit algorithm validation on receiving servers, prohibiting the insecure "alg: none" algorithm and enforcing strict signature verification.

  4. [4]OWASPAuthoritative Security StandardOWASP Cheat Sheet Series • Token Storage & Revocation
    Verified Primary Source
    Technical Claim Supported:

    Details token theft mitigation, recommending storage in secure HttpOnly cookies over localStorage and outlining token revocation strategies.