Un token monouso è un valore che il server genera, consegna insieme a un form o a una pagina e accetta una sola volta. Se l’invio non contiene il token, se il token è scaduto, se è già stato usato o se appartiene a un altro form, il server rifiuta la richiesta. Il token può essere un numero casuale salvato sul server oppure un valore firmato con una chiave segreta, che il server sa verificare senza doverlo conservare.
Contro che cosa protegge
Il primo uso è contro il cross-site request forgery (CSRF): un sito ostile fa partire, dal browser di un utente autenticato, una richiesta verso un altro sito, sfruttando i cookie di sessione che il browser invia da solo. Senza un token che il sito ostile non può conoscere, il server non distingue la richiesta forzata da quella voluta. OWASP indica il token sincronizzato fra le difese principali, insieme agli attributi SameSite dei cookie.
Il secondo uso è contro l’automazione e la ripetizione. Un bot che invia lo stesso form mille volte deve ottenere mille token diversi, e ogni richiesta di token è un punto in cui si possono applicare limiti e verifiche. Un token monouso impedisce anche il replay, cioè la ripetizione di una richiesta intercettata.
Token e cache
Un token scritto dentro l’HTML di una pagina non va d’accordo con la cache di pagina: tutti i visitatori ricevono lo stesso token, che inoltre scade mentre la pagina resta in cache. La soluzione è chiedere il token con una richiesta separata, fatta dal browser quando la pagina è già caricata. È lo stesso problema che incontrano i nonce di WordPress nelle pagine salvate in cache.
In ThinkShield
ThinkShield chiede il token per ogni form protetto all’endpoint /thinkshield/v1/challenge, quindi dopo il caricamento della pagina, in modo compatibile con la cache. Il token vale due ore, è legato al form per cui è stato emesso e si consuma al primo uso: un token riutilizzato, scaduto o emesso per un altro modulo blocca l’invio. Insieme al token il browser invia la soluzione della proof-of-work, che il token stesso definisce.