Salta al contenuto principale
Sistemi Attivi
WP Planet — WordPress Cloud & Managed Services
Torna al MagazineSicurezza

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

19 Nov 2026 — 15:20 6 min di lettura
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:

PHP
// 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' );
Nota: check_admin_referer fa due cose: verifica il nonce con wp_verify_nonce e, se non è valido, interrompe la richiesta con wp_die(). Non restituisce un booleano che potreste dimenticare di controllare. L'azione ('wpplanet_salva_impostazioni') deve essere identica in wp_nonce_field e in check_admin_referer: se differisce di un carattere, il nonce non passa mai. Il nonce non sostituisce il controllo dei permessi: current_user_can va sempre fatto prima.

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:

PHP
// 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 ] );
} );
Nota: Per le REST API, wp_create_nonce('wp_rest') genera il token che va nell'header X-WP-Nonce. Il core verifica automaticamente i nonce delle REST API se l'utente è autenticato via cookie. Ma se la vostra REST API accetta richieste pubbliche senza nonce, assicuratevi che le azioni di scrittura siano protette con un nonce o con un controllo di capability.

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.

Audit di sicurezza

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.

Audit di sicurezza
Condividi