...
Eroare ASP.NET Core · Autentificare, JWT, CORS și teste

403 Forbidden la un endpoint cu RequireRole sau [Authorize(Roles = "...")]

Pe scurt

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 admin din token nu satisface Admin;
  • 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 (implicit ClaimTypes.Role, la care e mapat role). Dacă furnizorul pune rolurile în roles sau groups, trebuie setat RoleClaimType;
  • mai multe cerințe: RequireRole("admin", "editor") înseamnă oricare, dar două RequireRole succesive înseamnă ambele.

Decodează tokenul și compară claim-urile cu cerința.

De ce apare: cauzele frecvente

1Majuscule diferite

Greșit
C#
.RequireAuthorization(p => p.RequireRole("Admin")); // tokenul are "admin"
Corect
C#
.RequireAuthorization(p => p.RequireRole("admin"));

Comparația rolurilor e exactă; folosește aceeași formă peste tot (ideal din constante).

2Rolurile în alt claim

Greșit
C#
o.TokenValidationParameters = new() { /* ... */ };
// tokenul are "roles": ["admin"]
Corect
C#
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

Greșit
C#
p.RequireRole("admin");
p.RequireRole("editor");
Corect
C#
p.RequireRole("admin", "editor");

Apelurile separate se cumulează (ambele roluri); un apel cu mai multe roluri cere oricare dintre ele.

Repară tu

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.

Codul care dă eroarea
C#
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();
După reparație, programul afișează
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.

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

← Toate erorile ASP.NET Core

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