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

System.NullReferenceException: Object reference not set to an instance of an object. (User.FindFirst("sub") întoarce null din cauza maparii claim-urilor)

Pe scurt

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ă

Greșit
C#
var id = user.FindFirst("sub")!.Value;
Corect
C#
var id = user.FindFirstValue(ClaimTypes.NameIdentifier);

Cu maparea implicită, sub se găsește sub tipul ClaimTypes.NameIdentifier.

2Dezactivarea mapării

Greșit
C#
.AddJwtBearer(o => o.TokenValidationParameters = new() { /* ... */ });
Corect
C#
.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

Greșit
C#
var plan = user.FindFirst("plan")!.Value;
Corect
C#
var plan = user.FindFirstValue("plan") ?? "gratuit";

FindFirstValue întoarce null fără excepție, iar tu alegi o valoare implicită sau răspunzi 403.

Repară tu

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.

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) =>
{
    var idUtilizator = user.FindFirst("sub")!.Value;
    return $"Comenzile utilizatorului {idUtilizator}";
}).RequireAuthorization();

app.Run();
După reparație, programul afișează
GET /comenzi/mele → 200 OK
Comenzile utilizatorului ana
Indiciu

Cu maparea implicită, sub ajunge sub tipul ClaimTypes.NameIdentifier.

Cum o eviți pe viitor

  • Alege o convenție (mapare implicită sau MapInboundClaims = false) și folosește-o consecvent.
  • Folosește FindFirstValue, care întoarce null, nu FindFirst(...)!.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

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