Nonce e verifica CSRF in WordPress: perché check_admin_referer non è opzionale

I nonce di WordPress non sono numeri casuali — sono token anti-CSRF legati a utente, azione e tempo. Dimenticare check_admin_referer nei form admin apre una vulnerabilità CSRF che permette di eseguire azioni come admin senza saperlo.
Il nome inganna: i 'nonce' di WordPress non sono numeri usati una volta (Number Used Once). Sono token anti-CSRF con una finestra temporale di validità di 12-24 ore, legati all'utente, all'azione e alla sessione. Il loro scopo è uno solo: impedire che un sito malevolo possa forzare il browser di un admin autenticato a eseguire azioni su WordPress senza che l'admin lo sappia. È la protezione contro il Cross-Site Request Forgery, e WordPress la gestisce con `wp_nonce_field`, `check_admin_referer` e `wp_verify_nonce`.
Il problema è che molti sviluppatori — e molti plugin — dimenticano di verificare il nonce nei form admin e nelle azioni AJAX. Un form senza nonce verification sembra funzionare perfettamente: l'admin lo compila, il dato si salva. Ma se un attaccante crea una pagina con un form che punta al vostro `/wp-admin/` con gli stessi campi, e l'admin la visita mentre è autenticato, il form viene inviato e l'azione eseguita. È un CSRF — Cross-Site Request Forgery — e WordPress ha la protezione integrata, basta usarla.
Il form admin completo con nonce
Un form admin corretto ha tre cose: un nonce field, un'azione nominata, e una verifica prima di elaborare. Ecco il pattern che seguiamo sempre:
// 1. Il form invia a admin-post.php con un campo "action"
function wpplanet_form_impostazioni() {
?>
<form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>">
<input type="hidden" name="action" value="wpplanet_salva" />
<?php wp_nonce_field( 'wpplanet_salva_impostazioni', 'wpplanet_impostazioni_nonce' ); ?>
<input type="text" name="wpplanet_valore"
value="<?php echo esc_attr( get_option( 'wpplanet_valore', '' ) ); ?>" />
<?php submit_button( 'Salva' ); ?>
</form>
<?php
}
// 2. Verificare permessi e nonce PRIMA di salvare
function wpplanet_salva_impostazioni() {
if ( ! current_user_can( 'manage_options' ) ) {
wp_die( 'Permessi insufficienti.' );
}
// Se il nonce non è valido, check_admin_referer interrompe con wp_die()
check_admin_referer( 'wpplanet_salva_impostazioni', 'wpplanet_impostazioni_nonce' );
update_option( 'wpplanet_valore', sanitize_text_field( wp_unslash( $_POST['wpplanet_valore'] ?? '' ) ) );
wp_safe_redirect( wp_get_referer() ?: admin_url() );
exit;
}
// "admin_post_" + il valore del campo action del form
add_action( 'admin_post_wpplanet_salva', 'wpplanet_salva_impostazioni' );AJAX e REST API: nonce diversi per contesti diversi
Le richieste AJAX in WordPress hanno una regola diversa. Admin-ajax usa `check_ajax_referer` che verifica un nonce passato via header o campo POST. Le REST API di WordPress usano i nonce tramite i cookie `wp_rest` e il parametro `_wpnonce` nell'header. Il pattern AJAX:
// Frontend: passare il nonce allo script JS
wp_localize_script( 'wpplanet-script', 'wpplanetAjax', [
'url' => admin_url( 'admin-ajax.php' ),
'nonce' => wp_create_nonce( 'wpplanet_ajax_action' ),
] );
// Backend: verificare prima di elaborare
add_action( 'wp_ajax_wpplanet_salva_dato', function() {
check_ajax_referer( 'wpplanet_ajax_action', 'nonce' );
$dato = sanitize_text_field( $_POST['dato'] ?? '' );
wp_send_json_success( [ 'salvato' => $dato ] );
} );Un dettaglio che spesso confonde: i nonce di WordPress durano 24 ore, ma il token viene rigenerato ogni 12 ore (con una finestra di tolleranza di 12 ore, quindi in pratica 24 ore di validità totale). Questo significa che una pagina con un form aperta per ore continua a funzionare. Ma se l'utente ha un form aperto da più di 24 ore, il nonce scade e `check_admin_referer` lo ferma con un errore di sicurezza. Non è un bug — è la funzione. I nonce non sono eterni, e non devono esserlo: meno tempo vivono, meno tempo un attaccante ha per usarli.
I form senza nonce sono una vulnerabilità CSRF che l'audit individua in minuti.
Un audit di sicurezza analizza i form admin, le azioni AJAX e le REST API del vostro WordPress per verificare che ogni azione scrivita sia protetta da nonce.
Articoli correlati

Due fattori WordPress con app: Google Authenticator, Authy e perché SMS non basta
Leggi
Spam e anti-bot WordPress: fermare i bot senza bloccare gli utenti veri
Leggi
