403 Forbidden la un endpoint cu RequireRole sau [Authorize(Roles = "...")]
Utilizatorul e autentificat (tokenul e valid), dar nu îndeplinește cerința de autorizare: nu are rolul, claim-ul sau politica cerută. Verifică ce roluri sunt în token (claim-ul role), dacă numele coincide exact (rolurile sunt sensibile la majuscule) și dacă RoleClaimType e cel potrivit.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
403 Forbidden vine după autentificare: serverul știe cine ești, dar regulile endpoint-ului nu te lasă. Pentru un endpoint cu RequireRole("Admin"), [Authorize(Roles = "Admin")] sau o politică, handler-ul de autorizare evaluează cerințele, iar dacă una nu e îndeplinită, răspunde 403 (fără corp, implicit).
Când utilizatorul ar trebui să aibă acces, cauzele obișnuite sunt:
- numele rolului diferă: comparația rolurilor e sensibilă la majuscule, deci
admindin token nu satisfaceAdmin; - rolul nu e în token: login-ul nu adaugă claim-ul
role, sau tokenul vechi a fost emis înainte să primească rolul; - tipul claim-ului: rolurile sunt căutate în
RoleClaimType(implicitClaimTypes.Role, la care e mapatrole). Dacă furnizorul pune rolurile înrolessaugroups, trebuie setatRoleClaimType; - mai multe cerințe:
RequireRole("admin", "editor")înseamnă oricare, dar douăRequireRolesuccesive înseamnă ambele.
Decodează tokenul și compară claim-urile cu cerința.
De ce apare: cauzele frecvente
1Majuscule diferite
.RequireAuthorization(p => p.RequireRole("Admin")); // tokenul are "admin".RequireAuthorization(p => p.RequireRole("admin"));Comparația rolurilor e exactă; folosește aceeași formă peste tot (ideal din constante).
2Rolurile în alt claim
o.TokenValidationParameters = new() { /* ... */ };
// tokenul are "roles": ["admin"]o.TokenValidationParameters = new()
{
/* ... */
RoleClaimType = "roles"
};RoleClaimType îi spune lui ASP.NET Core din ce claim citește rolurile pentru IsInRole și RequireRole.
3Două cerințe în loc de una cu variante
p.RequireRole("admin");
p.RequireRole("editor");p.RequireRole("admin", "editor");Apelurile separate se cumulează (ambele roluri); un apel cu mai multe roluri cere oricare dintre ele.
Repară eroarea, direct în pagină
Administratorii primesc 403 Forbidden la GET /admin/rapoarte, deși tokenul lor are rolul admin. Repară regula grupului /admin ca un administrator să primească raportul, iar un utilizator fără rol să rămână la 403.
using System.Security.Claims;
using System.Text;
using Microsoft.AspNetCore.Authentication.JwtBearer;
using Microsoft.IdentityModel.Tokens;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme).AddJwtBearer(o =>
o.TokenValidationParameters = new TokenValidationParameters
{
ValidIssuer = "academia",
ValidAudience = "magazin",
IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("o-cheie-secreta-de-cel-putin-32-de-octeti")),
});
builder.Services.AddAuthorization();
var app = builder.Build();
app.UseAuthentication();
app.UseAuthorization();
var admin = app.MapGroup("/admin").RequireAuthorization(p => p.RequireRole("Admin"));
admin.MapGet("/rapoarte", () => "Raport vânzări: 12 comenzi");
app.Run();GET /admin/rapoarte → 200 OK Raport vânzări: 12 comenzi GET /admin/rapoarte → 403 Forbidden
Indiciu
Compară exact, literă cu literă, rolul cerut de grup cu cel din token.
Reparația
using System.Security.Claims;
using System.Text;
using Microsoft.AspNetCore.Authentication.JwtBearer;
using Microsoft.IdentityModel.Tokens;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme).AddJwtBearer(o =>
o.TokenValidationParameters = new TokenValidationParameters
{
ValidIssuer = "academia",
ValidAudience = "magazin",
IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("o-cheie-secreta-de-cel-putin-32-de-octeti")),
});
builder.Services.AddAuthorization();
var app = builder.Build();
app.UseAuthentication();
app.UseAuthorization();
var admin = app.MapGroup("/admin").RequireAuthorization(p => p.RequireRole("admin"));
admin.MapGet("/rapoarte", () => "Raport vânzări: 12 comenzi");
app.Run();De ce merge
Grupul cerea rolul Admin, iar tokenurile conțin admin; comparația rolurilor e sensibilă la majuscule, deci nimeni nu trecea. Cu RequireRole("admin"), administratorul primește raportul, iar Ana, autentificată dar fără rol, primește în continuare 403. Pentru a evita astfel de diferențe, păstrează numele rolurilor în constante comune.
Cum o eviți pe viitor
- Ține numele rolurilor în constante comune pentru login și pentru autorizare.
- Testează fiecare endpoint protejat cu trei utilizatori: anonim (401), fără rol (403), cu rol (2xx).
- După ce schimbi rolurile unui utilizator, el trebuie să obțină un token nou.
- Pentru depanare, expune temporar un endpoint care afișează claim-urile utilizatorului curent.
Întrebări frecvente
De ce 403 nu are corp?
Handler-ul JWT trimite doar statusul. Poți adăuga ProblemDetails cu AddProblemDetails() și UseStatusCodePages(), sau un IAuthorizationMiddlewareResultHandler propriu.
Când ar trebui să întorc 404 în loc de 403?
Când nici existența resursei nu trebuie dezvăluită (de exemplu comanda altui client). Pentru zone administrative, 403 e răspunsul obișnuit.
Erori înrudite
System.InvalidOperationException: The AuthorizationPolicy named: 'Majori' was not found. Endpoint-ul cere o politică de autorizare cu un nume (RequireAuthorization("Majori") sau [Authorize(Policy = "Majori")]) care nu a fost definită. Adaug-o în AddAuthorization(o => o.AddPolicy("Majori", ...)), cu exact același nume. 401 Unauthorized cu antetul WWW-Authenticate: Bearer (fără token sau token trimis greșit) Endpoint-ul cere un utilizator autentificat, iar cererea nu are un token valid în antetul Authorization. Trimite antetul exact în forma Authorization: Bearer <token> (cu cuvântul Bearer și un spațiu), fără ghilimele în jurul tokenului. System.InvalidOperationException: No authenticationScheme was specified, and there was no DefaultForbidScheme found. The default schemes can be set using either AddAuthentication(string defaultScheme) or AddAuthentication(Action<AuthenticationOptions> configureOptions). Ai întors Results.Forbid() (sau Forbid() din controller) într-o aplicație fără schemă de autentificare. Forbid deleagă răspunsul 403 handler-ului de autentificare. Configurează autentificarea, sau, dacă nu ai, întoarce direct Results.StatusCode(403). Învață ASP.NET Core de la zero, cu exerciții la fiecare lecție
Curs ASP.NET Core: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 20 lecții sunt gratuite.
