Invalid CSRF token found for http://localhost:8080/api/comenzi
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
http.authorizeHttpRequests(a -> a.anyRequest().authenticated())
.oauth2ResourceServer(o -> o.jwt(Customizer.withDefaults()));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
fetch('/api/comenzi', { method: 'POST', body })http.csrf(c -> c.csrfTokenRepository(CookieCsrfTokenRepository.withHttpOnlyFalse()));
// frontend: antetul X-XSRF-TOKEN cu valoarea cookie-ului XSRF-TOKENCu sesiune, păstrezi protecția și trimiți tokenul la fiecare cerere care modifică date.
3Test MockMvc fără token
mvc.perform(post("/api/comenzi").content(json))mvc.perform(post("/api/comenzi").with(csrf()).content(json))with(csrf()) din spring-security-test adaugă un token valid în test.
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.
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");
}
}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.
Reparația
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");
String auth = req.getHeader("Authorization");
boolean stateless = auth != null && auth.startsWith("Bearer ");
if (modifica && !stateless && 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");
}
}De ce merge
CSRF exploatează cookie-urile trimise automat de browser. O cerere care se autentifică cu Authorization: Bearer nu folosește cookie-uri, deci nu poate fi falsificată de alt site, iar verificarea CSRF doar o bloca. Echivalentul în Spring Security este http.csrf(csrf -> csrf.disable()) pentru un API stateless. Cererile fără token rămân verificate.
Alte forme ale mesajului
403 ForbiddenInvalid 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
POSTdă 403 șiGETmerge, 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
Access Denied Utilizatorul e autentificat, dar regula de autorizare l-a respins (AccessDeniedException, 403 Forbidden). Cauze frecvente: rolul nu corespunde (hasRole("ADMIN") caută ROLE_ADMIN), utilizatorul chiar nu are rolul, sau CSRF a blocat un POST. Verifică rolurile din token și regula exactă. Full authentication is required to access this resource Spring Security a respins cererea cu 401 Unauthorized pentru că nu a găsit un utilizator autentificat: lipsește antetul Authorization, tokenul e invalid sau expirat, ori e trimis în alt format decât așteaptă serverul (de exemplu fără prefixul Bearer). Verifică antetul trimis și felul în care filtrul îl citește. Î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.
