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

Full authentication is required to access this resource

Pe scurt

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ă Authorization sau î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

Greșit
JAVA
GET /api/profil
Corect
JAVA
GET /api/profil
Authorization: Bearer t-ana-41

Fără antet, nicio rută protejată nu poate identifica utilizatorul.

2Filtrul nu taie prefixul Bearer

Greșit
JAVA
String token = req.getHeader("Authorization");
tokenuri.get(token); // "Bearer t-ana-41"
Corect
JAVA
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

Greșit
JAVA
// JWT cu exp în trecut
Authorization: Bearer eyJhbGciOi...
Corect
JAVA
// cere un token nou de la /login sau cu refresh token

Un JWT expirat e respins ca neautentificat; clientul trebuie să-l reînnoiască.

Repară tu

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.

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);
    }
}

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") + "!";
    }
}
După reparație, programul afișează
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.

Alte forme ale mesajului

  • org.springframework.security.authentication.InsufficientAuthenticationException: Full authentication is required to access this resource
  • 401 Unauthorized
  • Bearer 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 cu substring(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

← 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.