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

Access Denied

Pe scurt

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

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

Ce înseamnă

Mesajul Access Denied vine din AccessDeniedException: Spring Security știe cine ești (autentificarea a reușit), dar regula pentru ruta sau metoda cerută spune că nu ai voie. Răspunsul e 403 Forbidden.

Cea mai frecventă confuzie e prefixul ROLE_. În Spring Security, hasRole("ADMIN") și @PreAuthorize("hasRole('ADMIN')") caută autoritatea ROLE_ADMIN, iar hasAuthority("ADMIN") caută exact ADMIN. Dacă rolurile din baza de date sau din JWT sunt salvate fără prefix (sau cu prefix dublu), regula nu se potrivește niciodată și chiar și administratorul primește 403.

Alte cauze: ordinea regulilor în authorizeHttpRequests (prima regulă potrivită câștigă), un convertor JWT care pune rolurile în alt claim (scope față de roles) și protecția CSRF, care răspunde tot 403 la POST/PUT/DELETE fără token CSRF.

De ce apare: cauzele frecvente

1Prefixul ROLE_ nu corespunde

Greșit
JAVA
// rolul salvat: "ADMIN"
.requestMatchers("/api/admin/**").hasRole("ADMIN")
Corect
JAVA
// rolul salvat: "ROLE_ADMIN"
.requestMatchers("/api/admin/**").hasRole("ADMIN")
// sau rolul "ADMIN" cu .hasAuthority("ADMIN")

hasRole adaugă singur prefixul ROLE_; datele trebuie să-l conțină.

2Ordinea regulilor

Greșit
JAVA
.requestMatchers("/api/**").hasRole("USER")
.requestMatchers("/api/admin/**").hasRole("ADMIN")
Corect
JAVA
.requestMatchers("/api/admin/**").hasRole("ADMIN")
.requestMatchers("/api/**").hasRole("USER")

Regulile se evaluează în ordine; cele specifice trebuie puse primele.

3CSRF la cereri care modifică date

Greșit
JAVA
POST /api/comenzi  // fără token CSRF, sesiune cu cookie
Corect
JAVA
http.csrf(csrf -> csrf.disable()) // doar pentru API-uri stateless cu token
// sau trimite antetul X-XSRF-TOKEN

CSRF respinge cererile nesigure fără token, tot cu 403.

Repară tu

Repară eroarea, direct în pagină

Ana are rolul ROLE_ADMIN, dar GET /api/admin/rapoarte îi răspunde 403 cu Access Denied. Filtrul compară rolul cu "ADMIN", fără prefix. Corectează comparația ca un administrator să primească raportul.

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 Conturi {
    static final Map<String, String> UTILIZATORI = Map.of("t-ana-41", "ana", "t-ion-77", "ion");
    static final Map<String, String> ROLURI = Map.of("ana", "ROLE_ADMIN", "ion", "ROLE_USER");
}

@Component
class RolFilter extends OncePerRequestFilter {
    @Override
    protected void doFilterInternal(HttpServletRequest req, HttpServletResponse res, FilterChain chain)
            throws ServletException, IOException {
        String antet = req.getHeader("Authorization");
        String utilizator = antet != null && antet.startsWith("Bearer ") ? Conturi.UTILIZATORI.get(antet.substring(7)) : null;
        if (utilizator == null) {
            res.setStatus(401);
            return;
        }
        String rol = Conturi.ROLURI.get(utilizator);
        if (req.getRequestURI().startsWith("/api/admin") && !rol.equals("ADMIN")) {
            res.setStatus(403);
            res.setContentType("application/json");
            res.getWriter().write("{\"status\":403,\"error\":\"Forbidden\",\"message\":\"Access Denied\"}");
            return;
        }
        req.setAttribute("utilizator", utilizator);
        chain.doFilter(req, res);
    }
}

@RestController
class AdminController {
    @GetMapping("/api/admin/rapoarte")
    String rapoarte(HttpServletRequest req) {
        return "Rapoarte pentru " + req.getAttribute("utilizator");
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /api/admin/rapoarte → 200
Rapoarte pentru ana
Indiciu

Rolurile sunt salvate cu prefixul ROLE_, ca în Spring Security.

Alte forme ale mesajului

  • org.springframework.security.access.AccessDeniedException: Access Denied
  • 403 Forbidden
  • There was an unexpected error (type=Forbidden, status=403).

Cum o eviți pe viitor

  • Stabilește o convenție pentru roluri (cu sau fără ROLE_) și folosește hasRole sau hasAuthority în consecință.
  • Pune regulile specifice înaintea celor generale.
  • Activează logging.level.org.springframework.security=DEBUG ca să vezi autoritățile utilizatorului.
  • Scrie teste pentru fiecare rol: cine are voie și cine nu.
  • Nu „repara” un 403 dând tuturor acces.

Întrebări frecvente

Cum văd ce roluri are utilizatorul?

Într-un controller: SecurityContextHolder.getContext().getAuthentication().getAuthorities(); sau din jurnalul DEBUG al securității.

Primesc 403 la POST, dar GET merge. De ce?

Aproape sigur e CSRF: e activ implicit și se aplică doar metodelor care modifică date.

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.