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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Codul 401 Unauthorized înseamnă, de fapt, „neautentificat”: serverul nu știe cine ești. Când endpoint-ul are RequireAuthorization() sau [Authorize] și middleware-ul de autentificare nu a găsit un utilizator valid, ASP.NET Core răspunde 401 și adaugă antetul WWW-Authenticate: Bearer, prin care îi spune clientului ce schemă de autentificare așteaptă.
Dacă antetul are doar Bearer, fără error="invalid_token", cererea nu avea deloc un token recunoscut. Cauze frecvente:
- antetul
Authorizationlipsește (clientul nu a făcut login sau nu a salvat tokenul); - tokenul e trimis fără prefixul
Bearer(Authorization: eyJhbGci...); - e trimis în alt antet (
Token,X-Auth) sau în query string; - în Postman, tokenul e pus la alt request sau în alt mediu.
Când tokenul există, dar e respins, antetul conține și motivul (error="invalid_token", error_description="..."), iar paginile despre semnătură, expirare, issuer și audience explică fiecare caz.
De ce apare: cauzele frecvente
1Tokenul trimis fără prefixul Bearer
Authorization: eyJhbGciOiJIUzI1NiIs...Authorization: Bearer eyJhbGciOiJIUzI1NiIs...Handler-ul JWT citește doar antete care încep cu schema Bearer urmată de un spațiu.
2Clientul nu atașează tokenul
var r = await http.GetAsync("/comenzi/mele");http.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", token);
var r = await http.GetAsync("/comenzi/mele");Tokenul primit la login trebuie trimis la fiecare cerere protejată.
3Ghilimele în jurul tokenului
Authorization: Bearer "eyJhbGciOiJIUzI1NiIs..."Authorization: Bearer eyJhbGciOiJIUzI1NiIs...Tokenul copiat dintr-un răspuns JSON păstrează uneori ghilimelele; cu ele, nu mai e un JWT valid.
Repară eroarea, direct în pagină
Aplicația mobilă primește 401 Unauthorized la GET /comenzi/mele. Endpoint-ul e corect protejat; problema e în cererea trimisă. Laboratorul trimite cererea așa cum o trimite aplicația: privește antetul WWW-Authenticate, apoi adaugă endpoint-ul public GET /stare care răspunde API pornit, ca echipa mobilă să poată verifica serverul fără token.
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("/comenzi/mele", (ClaimsPrincipal user) => $"Comenzile lui {user.Identity!.Name}").RequireAuthorization();
app.Run();GET /comenzi/mele → 401 Unauthorized WWW-Authenticate: Bearer GET /stare → 200 OK API pornit GET /comenzi/mele → 200 OK Comenzile lui ana
Indiciu
Un endpoint public nu are RequireAuthorization().
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("/comenzi/mele", (ClaimsPrincipal user) => $"Comenzile lui {user.Identity!.Name}").RequireAuthorization();
app.MapGet("/stare", () => "API pornit");
app.Run();De ce merge
Antetul WWW-Authenticate: Bearer, fără error, arată că cererea nu avea niciun token: protecția funcționează, iar clientul trebuie să trimită Authorization: Bearer <token>. Endpoint-ul /stare, fără RequireAuthorization(), rămâne accesibil oricui și răspunde 200, ceea ce separă problemele de rețea de cele de autentificare. Cu un token valid, /comenzi/mele răspunde normal.
Alte forme ale mesajului
WWW-Authenticate: Bearer error="invalid_token"
Cum o eviți pe viitor
- Centralizează atașarea tokenului în client (un
DelegatingHandler, un interceptor HTTP în frontend). - În Postman, folosește tab-ul Authorization cu tipul „Bearer Token” și o variabilă de mediu.
- Citește antetul
WWW-Authenticatedin răspuns: îți spune dacă tokenul lipsește sau de ce a fost respins. - Expune un endpoint de test (
/eu) care arată identitatea, util la depanare.
Întrebări frecvente
401 sau 403: care e diferența?
401 înseamnă că serverul nu te-a autentificat (token lipsă sau invalid). 403 înseamnă că te-a recunoscut, dar nu ai dreptul la resursă (de exemplu îți lipsește rolul).
De ce răspunsul 401 nu are corp?
Handler-ul JWT trimite doar statusul și antetul WWW-Authenticate. Dacă vrei un corp ProblemDetails, poți folosi AddProblemDetails() împreună cu UseStatusCodePages() sau evenimentul OnChallenge din JwtBearerEvents.
Erori înrudite
WWW-Authenticate: Bearer error="invalid_token", error_description="The signature is invalid" Tokenul a fost semnat cu altă cheie decât cea cu care API-ul verifică semnătura. Folosește aceeași cheie secretă (din configurare, nu scrisă de două ori în cod) la generarea tokenului și în IssuerSigningKey din AddJwtBearer. 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. 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). Î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.
