401 Unauthorized cu token valid (UseAuthorization() apelat înainte de UseAuthentication())
Middleware-ul de autorizare rulează înaintea celui de autentificare, deci vede mereu un utilizator anonim și răspunde 401, chiar cu token valid. Apelează app.UseAuthentication() înainte de app.UseAuthorization() (ambele după UseRouting, dacă îl apelezi explicit).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Pipeline-ul de middleware rulează în ordinea în care e scris. Autentificarea citește tokenul și completează HttpContext.User; autorizarea verifică dacă acel utilizator are voie la endpoint. Dacă inversezi ordinea, autorizarea rulează când User e încă anonim și răspunde 401, iar autentificarea vine prea târziu.
Simptomul e derutant: tokenul e corect (îl poți decoda, semnătura e bună), dar orice endpoint protejat dă 401, iar antetul WWW-Authenticate conține doar Bearer, fără error.
Ordinea recomandată în .NET 8:
UseExceptionHandler,UseHttpsRedirection,UseStaticFiles;UseRouting(dacă îl apelezi explicit);UseCors;UseAuthentication;UseAuthorization;- middleware-urile tale care au nevoie de utilizator, apoi endpoint-urile.
Cu WebApplication, dacă nu apelezi deloc cele două metode, framework-ul le adaugă automat, în ordinea corectă. Problema apare doar când le scrii tu, inversate.
De ce apare: cauzele frecvente
1Ordine inversată
app.UseAuthorization();
app.UseAuthentication();app.UseAuthentication();
app.UseAuthorization();Utilizatorul trebuie stabilit înainte să fie verificat.
2Middleware propriu care citește User prea devreme
app.Use(async (ctx, next) =>
{
Console.WriteLine(ctx.User.Identity?.Name);
await next(ctx);
});
app.UseAuthentication();app.UseAuthentication();
app.Use(async (ctx, next) =>
{
Console.WriteLine(ctx.User.Identity?.Name);
await next(ctx);
});Orice cod care folosește ctx.User trebuie să ruleze după UseAuthentication.
3CORS după autorizare
app.UseAuthorization();
app.UseCors("web");app.UseCors("web");
app.UseAuthentication();
app.UseAuthorization();Cererile preflight CORS nu au token; dacă CORS e după autorizare, ele primesc 401 în loc de răspunsul CORS.
Repară eroarea, direct în pagină
Cu un token valid, GET /profil răspunde tot 401 Unauthorized. Configurarea JWT e corectă; problema e în pipeline. Repară-l ca utilizatorul autentificat să primească profilul.
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.UseAuthorization();
app.UseAuthentication();
app.MapGet("/profil", (ClaimsPrincipal user) => $"Profilul lui {user.Identity!.Name}").RequireAuthorization();
app.Run();GET /profil → 200 OK Profilul lui ana
Indiciu
Uită-te la ordinea în care sunt adăugate cele două middleware-uri de securitate.
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();
app.MapGet("/profil", (ClaimsPrincipal user) => $"Profilul lui {user.Identity!.Name}").RequireAuthorization();
app.Run();De ce merge
UseAuthorization() rula înaintea lui UseAuthentication(), deci verifica un utilizator încă anonim și răspundea 401 indiferent de token. Cu autentificarea înaintea autorizării, tokenul e citit și validat întâi, User e completat, iar autorizarea vede utilizatorul ana și lasă cererea să treacă.
Cum o eviți pe viitor
- Copiază ordinea de middleware din documentația oficială sau din șablonul
dotnet new webapi. - Nu apela
UseAuthentication/UseAuthorizationdacă nu ai nevoie de altă poziție:WebApplicationle adaugă singur. - Scrie un test de integrare cu un token valid pentru un endpoint protejat.
Întrebări frecvente
De ce nu primesc o eroare explicită despre ordine?
Pentru framework, ambele ordini sunt valide tehnic: autorizarea vede pur și simplu un utilizator anonim și răspunde 401, exact ca la o cerere fără token.
Mai trebuie UseRouting în .NET 8?
Nu, WebApplication îl adaugă automat la început. Îl apelezi explicit doar când vrei ca anumite middleware-uri să ruleze înaintea rutării.
Erori înrudite
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 DefaultChallengeScheme found. The default schemes can be set using either AddAuthentication(string defaultScheme) or AddAuthentication(Action<AuthenticationOptions> configureOptions). Un endpoint protejat trebuie să ceară autentificarea (challenge), dar aplicația nu are nicio schemă implicită. Înregistrează autentificarea cu o schemă: AddAuthentication(JwtBearerDefaults.AuthenticationScheme).AddJwtBearer(...). Î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.
