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

401 Unauthorized cu antetul WWW-Authenticate: Bearer (fără token sau token trimis greșit)

Pe scurt

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 Authorization lipseș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

Greșit
C#
Authorization: eyJhbGciOiJIUzI1NiIs...
Corect
C#
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

Greșit
C#
var r = await http.GetAsync("/comenzi/mele");
Corect
C#
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

Greșit
C#
Authorization: Bearer "eyJhbGciOiJIUzI1NiIs..."
Corect
C#
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Tokenul copiat dintr-un răspuns JSON păstrează uneori ghilimelele; cu ele, nu mai e un JWT valid.

Repară tu

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.

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();

app.MapGet("/comenzi/mele", (ClaimsPrincipal user) => $"Comenzile lui {user.Identity!.Name}").RequireAuthorization();

app.Run();
După reparație, programul afișează
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().

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-Authenticate din 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

← 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.