Nonce (wymowa: nons, od angielskiego number used once, czyli „liczba użyta raz”) to w informatyce wartość, która ma potwierdzić, że żądanie jest świeże i wysłane świadomie. W WordPressie nonce to krótki kod dołączany do formularzy i linków. Chroni przed atakiem CSRF, czyli wykonaniem akcji w Twoim imieniu bez Twojej wiedzy, np. przez podstawiony link w mailu.
Nazwa jest myląca: nonce w WordPressie nie jest liczbą ani wartością jednorazową. To ciąg liter i cyfr, który można użyć wiele razy, dopóki nie wygaśnie.
Do czego służy nonce
Nonce sprawdza intencję. Gdy klikasz „Usuń wpis” albo zapisujesz ustawienia wtyczki, WordPress porównuje kod z formularza lub linku z kodem, który wyliczył dla Ciebie i tej akcji. Jeśli kod się nie zgadza albo go brakuje, operacja zostaje przerwana z błędem 403.
Jak działa nonce w WordPressie
- Kod powstaje z nazwy akcji (np.
delete-post_123), zalogowanego użytkownika, jego sesji i czasu. - Domyślnie nonce jest ważny dobę. WordPress dzieli ten czas na dwa okresy i przyjmuje kod z bieżącego albo poprzedniego okresu, więc w praktyce kod wygasa po 12 do 24 godzinach. Długość zmienisz filtrem
nonce_life. - Kod jest związany z sesją. Po wylogowaniu i ponownym zalogowaniu nonce zapisane na otwartej karcie przestają działać.
- Niezalogowani odwiedzający mają w WordPressie ten sam identyfikator (0), więc dla tej samej akcji dostają ten sam kod. Zmienia to filtr
nonce_user_logged_out.
Jak użyć nonce w kodzie
Kod tworzysz jedną z trzech funkcji, zależnie od tego, gdzie ma trafić:
// Formularz: ukryte pole z nonce i adresem odsyłającym
wp_nonce_field( 'zapisz_ustawienia', 'moj_nonce' );
// Link: nonce doklejony do adresu jako parametr _wpnonce
$url = wp_nonce_url( admin_url( 'admin-post.php?action=wyczysc_cache' ), 'wyczysc_cache' );
// Sam kod, np. do wysłania w żądaniu AJAX
$nonce = wp_create_nonce( 'moj_ajax' );
Po stronie serwera sprawdzasz go tak:
// Formularz w panelu: sprawdza nonce i adres odsyłający, przy błędzie kończy z kodem 403
check_admin_referer( 'zapisz_ustawienia', 'moj_nonce' );
// Żądanie AJAX
check_ajax_referer( 'moj_ajax' );
// Własna logika: wp_verify_nonce() zwraca false, gdy kod jest nieprawidłowy
$kod = isset( $_POST['moj_nonce'] ) ? sanitize_text_field( wp_unslash( $_POST['moj_nonce'] ) ) : '';
if ( ! wp_verify_nonce( $kod, 'zapisz_ustawienia' ) ) {
wp_die( 'Nieprawidłowe żądanie.' );
}
Nonce to nie są uprawnienia
Dokumentacja WordPressa mówi wprost, że nonce nie służy do uwierzytelniania ani kontroli dostępu. Kod potwierdza tylko, że żądanie wyszło z Twojej strony. Czy dana osoba może wykonać akcję, sprawdzasz osobno funkcją current_user_can():
if ( ! current_user_can( 'manage_options' ) ) {
wp_die( 'Brak uprawnień.' );
}
check_admin_referer( 'zapisz_ustawienia', 'moj_nonce' );
Oba zabezpieczenia, nonce i sprawdzenie uprawnień, warto skontrolować w każdej wtyczce wygenerowanej przez AI. Jak to zrobić, pokazuję w poradniku jak sprawdzić wtyczkę WordPress napisaną przez AI.
Kiedy nonce sprawia kłopot
- Karta otwarta długo. Formularz wysłany po ponad 12 do 24 godzinach od wczytania strony zostanie odrzucony. Rozwiązanie: odświeżyć stronę przed wysłaniem.
- Cache całych stron. Jeśli serwer albo CDN zapamięta stronę razem z nonce, po wygaśnięciu kodu formularz może przestać działać dla wszystkich odwiedzających. Strony z formularzami wyłącz z cache albo pobieraj nonce osobnym żądaniem.
- Powtórzenie żądania. WordPress nie sprawdza, czy kod został już użyty, więc nonce nie chroni przed ponownym wysłaniem tego samego żądania w czasie ważności.
Powiązane hasła i poradniki
- AJAX w WordPress: żądania, w których nonce wysyła się najczęściej.
- REST API: zalogowane żądania z przeglądarki też potrzebują nonce.
- Hook: miejsce, w którym podpinasz obsługę formularza.
- Jak zabezpieczyć stronę na WordPress przed atakami
- Formularz kontaktowy nie wysyła wiadomości: jak to naprawić
Jak jest nonce po polsku?
Nie ma przyjętego polskiego odpowiednika. Dosłownie to „liczba użyta raz”, a w tekstach o bezpieczeństwie stron pisze się po prostu nonce albo token jednorazowy, choć w WordPressie nie jest on jednorazowy.
Ile ważny jest nonce w WordPressie?
Domyślnie dobę, a w praktyce od 12 do 24 godzin, bo WordPress przyjmuje kod z bieżącego i poprzedniego okresu ważności. Czas zmienia filtr nonce_life.
Źródła: WordPress Developer: Nonces. Hasło zaktualizowane 19 października 2026.


