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'.
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
var jwt = handler.ReadJwtToken(request.Headers.Authorization.ToString());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
var jwt = handler.ReadJwtToken(text);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
handler.ReadJwtToken(refreshToken);// 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ă 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.
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);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.
Reparația
using System.IdentityModel.Tokens.Jwt;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapPost("/token/info", (CerereToken c) =>
{
var token = c.Antet.StartsWith("Bearer ") ? c.Antet["Bearer ".Length..] : c.Antet;
var handler = new JwtSecurityTokenHandler();
if (!handler.CanReadToken(token))
return Results.BadRequest("Tokenul nu are formatul JWT.");
var jwt = handler.ReadJwtToken(token);
return Results.Ok(new { emitent = jwt.Issuer, utilizator = jwt.Subject });
});
app.Run();
public record CerereToken(string Antet);De ce merge
ReadJwtToken primea textul Bearer eyJ..., care nu e un JWT, și arunca SecurityTokenMalformedException. Tăind prefixul, rămâne doar tokenul, iar CanReadToken oprește textele invalide cu un 400 clar. Tokenul de exemplu e decodat: emitentul e academia, utilizatorul ana. Atenție: ReadJwtToken nu verifică semnătura, deci informațiile sunt bune pentru afișare, nu pentru autorizare.
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 deReadJwtToken. - Nu citi manual tokenul în endpoint-uri obișnuite: lasă
AddJwtBearersă-l valideze și foloseșteUser. - Reține că
ReadJwtTokennu verifică semnătura: pentru decizii de securitate foloseșteValidateToken.
Î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
WWW-Authenticate: Bearer error="invalid_token" (token malformat, fără error_description) Tokenul din antet nu e un JWT valid ca format: are prefixul Bearer de două ori, ghilimele, spații sau e trunchiat. Trimite exact Authorization: Bearer <token>, unde <token> are trei părți separate prin puncte. Microsoft.IdentityModel.Tokens.SecurityTokenInvalidSignatureException: IDX10511: Signature validation failed. Keys tried: 'Microsoft.IdentityModel.Tokens.SymmetricSecurityKey'. Niciuna dintre cheile din TokenValidationParameters nu verifică semnătura tokenului: tokenul a fost semnat cu altă cheie. Folosește la validare exact cheia (aceiași octeți) cu care a fost semnat, sau, la furnizori externi, cheile publice din metadata (Authority). Î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.
