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ă.
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
// rolul salvat: "ADMIN"
.requestMatchers("/api/admin/**").hasRole("ADMIN")// 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
.requestMatchers("/api/**").hasRole("USER")
.requestMatchers("/api/admin/**").hasRole("ADMIN").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
POST /api/comenzi // fără token CSRF, sesiune cu cookiehttp.csrf(csrf -> csrf.disable()) // doar pentru API-uri stateless cu token
// sau trimite antetul X-XSRF-TOKENCSRF respinge cererile nesigure fără token, tot cu 403.
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.
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");
}
}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.
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 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("ROLE_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");
}
}De ce merge
Rolurile sunt salvate în stilul Spring Security, cu prefixul ROLE_, iar filtrul compara cu ADMIN, deci nimeni nu trecea, nici administratorul. Este exact capcana dintre hasRole("ADMIN") (care caută ROLE_ADMIN) și hasAuthority("ADMIN"). Utilizatorii fără rol de administrator primesc în continuare 403.
Alte forme ale mesajului
org.springframework.security.access.AccessDeniedException: Access Denied403 ForbiddenThere 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ștehasRolesauhasAuthorityîn consecință. - Pune regulile specifice înaintea celor generale.
- Activează
logging.level.org.springframework.security=DEBUGca 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
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. 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. Î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.
