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

Microsoft.IdentityModel.Tokens.SecurityTokenMalformedException: IDX14100: JWT is not well formed, there are no dots (.). The token needs to be in JWS or JWE Compact Serialization Format. (JWS): 'EncodedHeader.EncodedPayload.EncodedSignature'. (JWE): 'EncodedProtectedHeader.EncodedEncryptedKey.EncodedInitializationVector.EncodedCiphertext.EncodedAuthenticationTag'.

Pe scurt

Textul dat lui ReadJwtToken sau ValidateToken nu e un JWT: nu are formatul antet.payload.semnătură. De obicei conține și prefixul Bearer, ghilimele, sau e alt tip de token. Curăță textul înainte și verifică formatul cu CanReadToken.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un JWT compact are trei părți Base64Url separate prin puncte (JWS) sau cinci, dacă e criptat (JWE). JwtSecurityTokenHandler.ReadJwtToken, ValidateToken și JsonWebTokenHandler verifică întâi formatul; dacă textul nu are punctele așteptate, aruncă SecurityTokenMalformedException cu IDX14100 (sau IDX12741 / IDX14101 în variantele apropiate).

Cauze frecvente:

  • ai trecut tot antetul HTTP (Bearer eyJ...), nu doar tokenul: spațiul și prefixul strică parsarea (iar dacă textul nu conține deloc puncte, ca la un token opac, mesajul e exact IDX14100);
  • textul are ghilimele sau spații albe (din JSON, dintr-un fișier, dintr-o variabilă de mediu);
  • e un token opac (refresh token, cod de autorizare, cheie API), nu un JWT;
  • tokenul a fost trunchiat.

În handler-ul JwtBearer, aceeași problemă devine un 401 cu error="invalid_token"; aici o vezi direct, pentru că ai apelat tu biblioteca.

De ce apare: cauzele frecvente

1Prefixul Bearer trimis la parsare

Greșit
C#
var jwt = handler.ReadJwtToken(request.Headers.Authorization.ToString());
Corect
C#
var antet = request.Headers.Authorization.ToString();
var token = antet.StartsWith("Bearer ") ? antet["Bearer ".Length..] : antet;
var jwt = handler.ReadJwtToken(token);

Doar partea de după Bearer e JWT-ul.

2Fără verificarea formatului

Greșit
C#
var jwt = handler.ReadJwtToken(text);
Corect
C#
if (!handler.CanReadToken(text)) return Results.BadRequest("Token invalid.");
var jwt = handler.ReadJwtToken(text);

CanReadToken verifică formatul fără excepție, ca să răspunzi cu 400.

3Token opac în loc de JWT

Greșit
C#
handler.ReadJwtToken(refreshToken);
Corect
C#
// refresh token-ul e opac: îl cauți în baza de date
var sesiune = db.Sesiuni.Find(refreshToken);

Nu toate tokenurile sunt JWT; refresh token-urile sunt adesea șiruri aleatoare.

Repară tu

Repară eroarea, direct în pagină

POST /token/info răspunde 500 cu IDX14100: JWT is not well formed când clientul trimite tot antetul Bearer <token>, iar pentru un text care nu e JWT. Elimină prefixul Bearer dacă există, verifică formatul cu CanReadToken și răspunde 400 cu Tokenul nu are formatul JWT. pentru texte invalide.

Codul care dă eroarea
C#
using System.IdentityModel.Tokens.Jwt;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapPost("/token/info", (CerereToken c) =>
{
    var jwt = new JwtSecurityTokenHandler().ReadJwtToken(c.Antet);
    return new { emitent = jwt.Issuer, utilizator = jwt.Subject };
});

app.Run();

public record CerereToken(string Antet);
După reparație, programul afișează
POST /token/info → 200 OK
{"emitent":"academia","utilizator":"ana"}
POST /token/info → 400 Bad Request
"Tokenul nu are formatul JWT."
Indiciu

Taie prefixul Bearer cu StartsWith și slicing, apoi apelează CanReadToken înainte de ReadJwtToken.

Alte forme ale mesajului

  • IDX12741: JWT must have three segments (JWS) or five segments (JWE).
  • IDX14101: Unable to decode the payload as Base64Url encoded string.

Cum o eviți pe viitor

  • Extrage tokenul din antet cu o funcție dedicată, testată (fără prefix, fără spații).
  • Verifică formatul cu CanReadToken înainte de ReadJwtToken.
  • Nu citi manual tokenul în endpoint-uri obișnuite: lasă AddJwtBearer să-l valideze și folosește User.
  • Reține că ReadJwtToken nu verifică semnătura: pentru decizii de securitate folosește ValidateToken.

Întrebări frecvente

ReadJwtToken validează tokenul?

Nu. Doar îl decodează. Semnătura, expirarea, issuer-ul și audience-ul se verifică doar cu ValidateToken sau de handler-ul JwtBearer.

De ce în API primesc 401, iar în codul meu excepție?

Handler-ul JwtBearer prinde excepția și o transformă în 401 cu invalid_token. Când chemi biblioteca direct, excepția ajunge la tine.

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.