Nel gergo della crittografia un nonce è un “number used once”, un numero usato una sola volta. In WordPress il termine indica qualcosa di diverso: un codice di dieci caratteri, ricavato con una funzione di hash dall’identità dell’utente, dalla sessione, dal nome dell’azione e da un intervallo di tempo, che il sito inserisce in link e form e verifica quando la richiesta torna indietro. Serve a proteggere da richieste forzate (CSRF) e da link manipolati.
Non è davvero monouso
La documentazione ufficiale lo dice chiaramente: un nonce di WordPress può essere usato più volte durante la sua validità. Dura di serie 24 ore, divise in due finestre di 12 ore: un nonce generato in una finestra resta valido anche in quella successiva. Non è un segreto né una prova di identità; non sostituisce il controllo dei permessi con le capability, che va fatto sempre a parte, con funzioni come current_user_can().
Nella REST API
Quando uno script nel browser chiama la REST API di WordPress con l’autenticazione a cookie, deve inviare un nonce con l’azione wp_rest nell’intestazione X-WP-Nonce. Senza, WordPress tratta la richiesta come anonima anche se il browser ha il cookie di accesso. È il meccanismo con cui l’editor a blocchi, Elementor e molti plugin parlano con il server.
Nonce e cache
Per i visitatori non autenticati il nonce dipende solo dall’azione e dal tempo, quindi è identico per tutti nella stessa finestra. In una pagina salvata in cache per più di 24 ore il nonce scade, e i form che lo usano smettono di funzionare per tutti fino al successivo svuotamento. È uno dei motivi per cui i plugin ThinkClouds che proteggono form pubblici chiedono i loro token con una richiesta separata dopo il caricamento della pagina, invece di scriverli nell’HTML.
Nei lavori di manutenzione dei siti ThinkClouds, il nonce per le chiamate REST si ottiene da una pagina di amministrazione con la richiesta admin-ajax.php?action=rest-nonce e si passa in X-WP-Nonce a tutte le chiamate successive.