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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine de la Spring Security (InsufficientAuthenticationException) și înseamnă că cererea a ajuns la o rută protejată fără o autentificare validă. Răspunsul e 401 Unauthorized: „nu știu cine ești”. Nu confunda cu 403, care înseamnă „știu cine ești, dar nu ai voie”.
Verifică, în ordine:
- clientul trimite antetul? Mulți uită
Authorizationsau îl pun ca parametru în URL; - formatul:
Authorization: Bearer <token>pentru JWT,Authorization: Basic <base64>pentru Basic. Prefixul, spațiul și literele mari contează; - tokenul e valid: nu a expirat, e semnat cu cheia corectă, are emitentul (
iss) și audiența așteptate; - filtrul de pe server citește corect antetul (de exemplu taie prefixul
Bearerînainte să caute tokenul).
Cu logging.level.org.springframework.security=DEBUG vezi în jurnal lanțul de filtre și motivul exact al respingerii.
De ce apare: cauzele frecvente
1Clientul nu trimite tokenul
GET /api/profilGET /api/profil
Authorization: Bearer t-ana-41Fără antet, nicio rută protejată nu poate identifica utilizatorul.
2Filtrul nu taie prefixul Bearer
String token = req.getHeader("Authorization");
tokenuri.get(token); // "Bearer t-ana-41"String antet = req.getHeader("Authorization");
if (antet != null && antet.startsWith("Bearer ")) {
tokenuri.get(antet.substring(7));
}Antetul conține și schema Bearer ; tokenul propriu-zis începe după ea.
3Tokenul a expirat
// JWT cu exp în trecut
Authorization: Bearer eyJhbGciOi...// cere un token nou de la /login sau cu refresh tokenUn JWT expirat e respins ca neautentificat; clientul trebuie să-l reînnoiască.
Repară eroarea, direct în pagină
Clientul trimite corect Authorization: Bearer t-ana-41, dar filtrul răspunde mereu 401 cu Full authentication is required to access this resource. Repară TokenFilter ca să accepte antetul cu prefixul Bearer și să caute doar tokenul.
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);
}
}
class Tokenuri {
static final Map<String, String> UTILIZATORI = Map.of("t-ana-41", "ana", "t-ion-77", "ion");
}
@Component
class TokenFilter extends OncePerRequestFilter {
@Override
protected void doFilterInternal(HttpServletRequest req, HttpServletResponse res, FilterChain chain)
throws ServletException, IOException {
String antet = req.getHeader("Authorization");
String utilizator = antet == null ? null : Tokenuri.UTILIZATORI.get(antet);
if (utilizator == null) {
res.setStatus(401);
res.setContentType("application/json");
res.getWriter().write("{\"status\":401,\"error\":\"Unauthorized\",\"message\":\"Full authentication is required to access this resource\"}");
return;
}
req.setAttribute("utilizator", utilizator);
chain.doFilter(req, res);
}
}
@RestController
class ProfilController {
@GetMapping("/api/profil")
String profil(HttpServletRequest req) {
return "Salut, " + req.getAttribute("utilizator") + "!";
}
}Tomcat started on port 8080 (http) Started Application GET /api/profil → 200 Salut, ana! GET /api/profil → 200 Salut, ion!
Indiciu
Antetul conține „Bearer ” înaintea tokenului: verifică prefixul și taie-l înainte de căutare.
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);
}
}
class Tokenuri {
static final Map<String, String> UTILIZATORI = Map.of("t-ana-41", "ana", "t-ion-77", "ion");
}
@Component
class TokenFilter extends OncePerRequestFilter {
@Override
protected void doFilterInternal(HttpServletRequest req, HttpServletResponse res, FilterChain chain)
throws ServletException, IOException {
String antet = req.getHeader("Authorization");
String utilizator = null;
if (antet != null && antet.startsWith("Bearer ")) {
utilizator = Tokenuri.UTILIZATORI.get(antet.substring(7));
}
if (utilizator == null) {
res.setStatus(401);
res.setContentType("application/json");
res.getWriter().write("{\"status\":401,\"error\":\"Unauthorized\",\"message\":\"Full authentication is required to access this resource\"}");
return;
}
req.setAttribute("utilizator", utilizator);
chain.doFilter(req, res);
}
}
@RestController
class ProfilController {
@GetMapping("/api/profil")
String profil(HttpServletRequest req) {
return "Salut, " + req.getAttribute("utilizator") + "!";
}
}De ce merge
Valoarea antetului este „Bearer t-ana-41”, iar filtrul căuta în hartă tot textul, care nu era o cheie, deci orice cerere primea 401. Acum filtrul verifică schema Bearer , taie primele 7 caractere și caută doar tokenul. Antetele fără prefix rămân respinse, cum trebuie.
Alte forme ale mesajului
org.springframework.security.authentication.InsufficientAuthenticationException: Full authentication is required to access this resource401 UnauthorizedBearer error="invalid_token", error_description="Jwt expired at 2026-03-01T10:00:00Z"
Cum o eviți pe viitor
- Documentează formatul exact al autentificării (
Authorization: Bearer <token>) și dă un exemplu în README sau în OpenAPI. - În filtre, verifică prefixul cu
startsWith("Bearer ")și taie-l cusubstring(7). - Răspunde la 401 cu un JSON clar, nu cu o pagină goală.
- Activează jurnalul DEBUG pentru securitate când depanezi.
- Testează ruta și fără token, și cu token greșit.
Întrebări frecvente
Care e diferența dintre 401 și 403?
401: cererea nu e autentificată (lipsă sau invalidă). 403: utilizatorul e autentificat, dar nu are rolul sau permisiunea necesară.
Merge din Postman, dar nu din aplicația web. De ce?
Fie aplicația web nu trimite antetul (verifică în DevTools, tab Network), fie cererea preflight CORS e blocată înainte de filtru.
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ă. 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. Using generated security password: 8e557245-73e2-4286-969a-ff57fe326336 Nu e o eroare, ci un avertisment: ai adăugat spring-boot-starter-security fără configurare proprie, așa că Spring Boot a creat un utilizator implicit (user) cu o parolă aleatoare și a protejat toate rutele. Definește un SecurityFilterChain care spune ce rute sunt publice și cum se autentifică restul. Î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.
