...
Eroare Spring Boot · Securitate, filtre și CORS

Invalid CSRF token found for http://localhost:8080/api/comenzi

Pe scurt

Protecția CSRF a lui Spring Security a respins o cerere care modifică date (POST, PUT, DELETE) pentru că nu avea tokenul CSRF. De aceea GET merge, iar POST dă 403. Pentru un API REST stateless, autentificat cu token în antet, dezactivează CSRF; pentru aplicații cu sesiune și cookie, trimite tokenul.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

CSRF (Cross-Site Request Forgery) e un atac în care un site străin face browserul victimei să trimită o cerere către aplicația ta, folosind automat cookie-ul de sesiune. Spring Security se apără implicit: orice cerere care modifică date (POST, PUT, PATCH, DELETE) trebuie să aibă un token CSRF, primit anterior de la server, în antetul X-XSRF-TOKEN (sau într-un câmp de formular). Fără el, filtrul CsrfFilter răspunde 403, iar în jurnalul DEBUG vezi Invalid CSRF token found for http://localhost:8080/api/comenzi.

Simptomul clasic: în Postman sau dintr-un client nou, GET merge, iar POST la aceeași rută dă 403, fără niciun mesaj în corp.

Decizia corectă depinde de autentificare. Un API stateless, unde clientul trimite Authorization: Bearer ... la fiecare cerere și nu există cookie de sesiune, nu e vulnerabil la CSRF: dezactivezi protecția. O aplicație cu sesiune în cookie (formular de login) trebuie să o păstreze și să trimită tokenul.

De ce apare: cauzele frecvente

1API REST cu JWT și CSRF activ

Greșit
JAVA
http.authorizeHttpRequests(a -> a.anyRequest().authenticated())
    .oauth2ResourceServer(o -> o.jwt(Customizer.withDefaults()));
Corect
JAVA
http.csrf(csrf -> csrf.disable())
    .sessionManagement(s -> s.sessionCreationPolicy(SessionCreationPolicy.STATELESS))
    .authorizeHttpRequests(a -> a.anyRequest().authenticated())
    .oauth2ResourceServer(o -> o.jwt(Customizer.withDefaults()));

Fără sesiune și cookie, CSRF nu are ce exploata, deci protecția doar blochează clienții legitimi.

2Aplicație web cu sesiune care nu trimite tokenul

Greșit
JAVA
fetch('/api/comenzi', { method: 'POST', body })
Corect
JAVA
http.csrf(c -> c.csrfTokenRepository(CookieCsrfTokenRepository.withHttpOnlyFalse()));
// frontend: antetul X-XSRF-TOKEN cu valoarea cookie-ului XSRF-TOKEN

Cu sesiune, păstrezi protecția și trimiți tokenul la fiecare cerere care modifică date.

3Test MockMvc fără token

Greșit
JAVA
mvc.perform(post("/api/comenzi").content(json))
Corect
JAVA
mvc.perform(post("/api/comenzi").with(csrf()).content(json))

with(csrf()) din spring-security-test adaugă un token valid în test.

Repară tu

Repară eroarea, direct în pagină

API-ul e stateless: clientul trimite Authorization: Bearer ... la fiecare cerere, fără cookie de sesiune. Totuși CsrfFilter respinge POST /api/comenzi cu 403 și Invalid CSRF token found. Lasă cererile cu token Bearer să treacă fără verificarea CSRF; restul rămân verificate.

Codul care dă eroarea
JAVA
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.stereotype.Component;
import org.springframework.web.filter.OncePerRequestFilter;
import jakarta.servlet.FilterChain;
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
import org.springframework.web.bind.annotation.*;
import java.util.*;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

@Component
class CsrfFilter extends OncePerRequestFilter {
    @Override
    protected void doFilterInternal(HttpServletRequest req, HttpServletResponse res, FilterChain chain)
            throws ServletException, IOException {
        boolean modifica = !req.getMethod().equals("GET");
        if (modifica && req.getHeader("X-XSRF-TOKEN") == null) {
            res.setStatus(403);
            res.setContentType("application/json");
            res.getWriter().write("{\"status\":403,\"error\":\"Forbidden\",\"message\":\"Invalid CSRF token found for http://localhost:8080" + req.getRequestURI() + "\"}");
            return;
        }
        chain.doFilter(req, res);
    }
}

record ComandaNoua(String produs, int cantitate) { }

@RestController
class ComandaController {
    @PostMapping("/api/comenzi")
    String plaseaza(@RequestBody ComandaNoua c) {
        return "Comandă primită: " + c.cantitate() + " x " + c.produs();
    }

    @GetMapping("/api/comenzi")
    List<String> lista() {
        return List.of("Comanda 1", "Comanda 2");
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /api/comenzi → 200
["Comanda 1","Comanda 2"]
POST /api/comenzi → 200
Comandă primită: 2 x Mouse
Indiciu

Calculează dacă cererea are antetul Authorization care începe cu Bearer și sari peste verificare în acest caz.

Alte forme ale mesajului

  • 403 Forbidden
  • Invalid CSRF Token 'null' was found on the request parameter '_csrf' or header 'X-CSRF-TOKEN'.
  • Could not verify the provided CSRF token because no token was found to compare.

Cum o eviți pe viitor

  • Decide de la început: API stateless (CSRF dezactivat, token în antet) sau aplicație cu sesiune (CSRF activ, token trimis).
  • Nu dezactiva CSRF într-o aplicație care se bazează pe cookie de sesiune.
  • În testele MockMvc, folosește .with(csrf()) pentru cererile care modifică date.
  • Când un POST dă 403 și GET merge, verifică întâi CSRF.

Întrebări frecvente

De ce primesc 403 fără niciun mesaj?

Spring Security trimite eroarea prin /error, care poate fi și ea protejată. Activează logging.level.org.springframework.security=DEBUG ca să vezi motivul exact.

E sigur să dezactivez CSRF?

Da, pentru API-uri care nu folosesc cookie-uri de autentificare (doar Authorization: Bearer). Nu, pentru aplicații cu login prin formular și sesiune.

Erori înrudite

← Toate erorile Spring Boot

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Spring Boot de la zero, cu exerciții la fiecare lecție

Curs Spring Boot și REST API: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 18 lecții sunt gratuite.