System.NullReferenceException: Object reference not set to an instance of an object. (User.FindFirst("sub") întoarce null din cauza maparii claim-urilor)
Handler-ul JwtBearer redenumește claim-urile standard la citire: sub devine ClaimTypes.NameIdentifier, role devine ClaimTypes.Role, unique_name devine ClaimTypes.Name. Caută claim-ul după numele mapat (FindFirstValue(ClaimTypes.NameIdentifier)) sau dezactivează maparea cu MapInboundClaims = false.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Tokenul conține claim-ul sub (identificatorul utilizatorului), îl poți vedea dacă îl decodezi. Totuși User.FindFirst("sub") întoarce null, iar .Value pe null aruncă NullReferenceException.
Cauza: din motive istorice (compatibilitate cu WS-Federation), JwtBearer mapează implicit numele scurte din JWT la URI-urile lungi din ClaimTypes:
sub→http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier(ClaimTypes.NameIdentifier);unique_name→ClaimTypes.Name;role→ClaimTypes.Role;email→ClaimTypes.Email.
După mapare, în User.Claims nu mai există niciun claim cu tipul sub. Ai două variante consecvente: cauți după numele mapat (ClaimTypes.NameIdentifier) sau setezi o.MapInboundClaims = false și folosești peste tot numele din JWT (sub, role), având grijă să setezi și NameClaimType/RoleClaimType ca User.Identity.Name și IsInRole să funcționeze.
Operatorul ! doar a ascuns avertismentul compilatorului; verificarea de null ar fi transformat excepția într-un răspuns clar.
De ce apare: cauzele frecvente
1Căutare după numele din JWT, cu maparea activă
var id = user.FindFirst("sub")!.Value;var id = user.FindFirstValue(ClaimTypes.NameIdentifier);Cu maparea implicită, sub se găsește sub tipul ClaimTypes.NameIdentifier.
2Dezactivarea mapării
.AddJwtBearer(o => o.TokenValidationParameters = new() { /* ... */ });.AddJwtBearer(o =>
{
o.MapInboundClaims = false;
o.TokenValidationParameters = new()
{
/* ... */
NameClaimType = "unique_name",
RoleClaimType = "role"
};
});Fără mapare, claim-urile păstrează numele din token; NameClaimType și RoleClaimType spun unde sunt numele și rolurile.
3! pe un claim care poate lipsi
var plan = user.FindFirst("plan")!.Value;var plan = user.FindFirstValue("plan") ?? "gratuit";FindFirstValue întoarce null fără excepție, iar tu alegi o valoare implicită sau răspunzi 403.
Repară eroarea, direct în pagină
GET /comenzi/mele răspunde 500 cu NullReferenceException, deși tokenul are claim-ul sub. Maparea claim-urilor e cea implicită; citește id-ul utilizatorului după numele mapat, ca răspunsul să fie Comenzile utilizatorului ana.
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) =>
{
var idUtilizator = user.FindFirst("sub")!.Value;
return $"Comenzile utilizatorului {idUtilizator}";
}).RequireAuthorization();
app.Run();GET /comenzi/mele → 200 OK Comenzile utilizatorului ana
Indiciu
Cu maparea implicită, sub ajunge sub tipul ClaimTypes.NameIdentifier.
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) =>
{
var idUtilizator = user.FindFirstValue(ClaimTypes.NameIdentifier);
return $"Comenzile utilizatorului {idUtilizator}";
}).RequireAuthorization();
app.Run();De ce merge
JwtBearer a redenumit sub în ClaimTypes.NameIdentifier la citirea tokenului, deci FindFirst("sub") întorcea null, iar .Value arunca excepția. FindFirstValue(ClaimTypes.NameIdentifier) caută numele mapat și găsește id-ul (pentru tokenul de test, ana). În plus, FindFirstValue nu aruncă excepție când claim-ul lipsește. Codul rămâne lizibil și sigur.
Cum o eviți pe viitor
- Alege o convenție (mapare implicită sau
MapInboundClaims = false) și folosește-o consecvent. - Folosește
FindFirstValue, care întoarcenull, nuFindFirst(...)!.Value. - Afișează claim-urile utilizatorului curent la depanare (
user.Claims.Select(c => $"{c.Type}={c.Value}")). - Rulează testele de integrare la fiecare modificare, ca problema să fie prinsă înainte de producție, nu raportată de utilizatori.
Întrebări frecvente
De ce User.Identity.Name merge, dar FindFirst("unique_name") nu?
unique_name a fost mapat la ClaimTypes.Name, iar Identity.Name citește exact acel tip. Claim-ul există, doar sub alt nume.
În .NET 8 maparea mai e activă?
Pentru AddJwtBearer, da: MapInboundClaims este true implicit. Noul JsonWebTokenHandler folosit din .NET 8 respectă aceeași setare.
Erori înrudite
System.NullReferenceException: Object reference not set to an instance of an object. (navigare EF Core neîncărcată, fără Include) EF Core nu încarcă automat entitățile legate: după ToList, p.Categorie e null dacă n-ai cerut-o. Adaugă Include(p => p.Categorie) în interogare sau proiectează direct în Select (p.Categorie.Nume), înainte de ToList. 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. Î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.
