WWW-Authenticate: Bearer error="invalid_token", error_description="The signature is invalid"
Tokenul a fost semnat cu altă cheie decât cea cu care API-ul verifică semnătura. Folosește aceeași cheie secretă (din configurare, nu scrisă de două ori în cod) la generarea tokenului și în IssuerSigningKey din AddJwtBearer.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un JWT are trei părți: antet, payload (claims) și semnătură. Semnătura HS256 se calculează din primele două părți cu o cheie secretă. La fiecare cerere, handler-ul JwtBearer recalculează semnătura cu cheia din TokenValidationParameters.IssuerSigningKey și o compară cu cea din token. Dacă diferă, tokenul a fost semnat cu altă cheie (sau a fost modificat) și cererea primește 401 cu error_description="The signature is invalid".
Cauze frecvente:
- endpoint-ul de login și validarea folosesc chei diferite (una scrisă în cod, alta din
appsettings.json; una din Development, alta din Production); - cheia diferă prin encoding (
UTF8față deASCIIsau Base64 decodat într-un loc și nu în altul); - tokenul vine de la alt mediu (staging) sau de la alt serviciu;
- cineva a modificat payload-ul (de exemplu rolul) fără să poată re-semna tokenul, exact situația pe care semnătura o previne.
În loguri, Microsoft.IdentityModel raportează eroarea ca IDX10511 sau IDX10503 („Signature validation failed”).
De ce apare: cauzele frecvente
1Chei diferite la emitere și la validare
var cheieLogin = "cheia-serviciului-de-login-de-minim-32-octeti";
// ...
IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("alta-cheie-...")),var cheie = builder.Configuration["Jwt:Cheie"]!;
// aceeași valoare la login și în AddJwtBearer
IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(cheie)),Cheia citită dintr-un singur loc al configurării nu mai poate diverge între emitere și validare.
2Encoding diferit
Encoding.ASCII.GetBytes(cheie) // la login
Encoding.UTF8.GetBytes(cheie) // la validareEncoding.UTF8.GetBytes(cheie) // în ambele locuriPentru caractere non-ASCII (de exemplu diacritice), octeții diferă, deci și semnătura.
3Token emis de alt mediu
// token copiat din staging, folosit pe local// generează tokenul pe același mediu
// sau folosește aceeași cheie doar intenționatFiecare mediu ar trebui să aibă cheia lui; un token din staging nu e valid în producție, și e bine așa.
Repară eroarea, direct în pagină
Utilizatorii se loghează cu succes, dar GET /profil răspunde 401 cu error_description="The signature is invalid". Endpoint-ul de login semnează cu cheia din Jwt:Cheie (appsettings.json), iar AddJwtBearer verifică cu altă cheie, scrisă în cod. Fă validarea să folosească aceeași cheie din configurare.
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("alta-cheie-scrisa-direct-in-cod-de-32-octeti")),
});
builder.Services.AddAuthorization();
var app = builder.Build();
app.UseAuthentication();
app.UseAuthorization();
app.MapPost("/login", (Login date, IConfiguration config) =>
{
var cheie = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(config["Jwt:Cheie"]!));
var token = new System.IdentityModel.Tokens.Jwt.JwtSecurityToken("academia", "magazin",
[new Claim("unique_name", date.Utilizator)], expires: DateTime.UtcNow.AddHours(1),
signingCredentials: new SigningCredentials(cheie, SecurityAlgorithms.HmacSha256));
return Results.Ok(new { token = new System.IdentityModel.Tokens.Jwt.JwtSecurityTokenHandler().WriteToken(token) });
});
app.MapGet("/profil", (ClaimsPrincipal user) => $"Profilul lui {user.Identity!.Name}").RequireAuthorization();
app.Run();
public record Login(string Utilizator, string Parola);GET /profil → 200 OK Profilul lui ana
Indiciu
Citește cheia cu builder.Configuration["Jwt:Cheie"] și folosește-o în IssuerSigningKey.
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(builder.Configuration["Jwt:Cheie"]!)),
});
builder.Services.AddAuthorization();
var app = builder.Build();
app.UseAuthentication();
app.UseAuthorization();
app.MapPost("/login", (Login date, IConfiguration config) =>
{
var cheie = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(config["Jwt:Cheie"]!));
var token = new System.IdentityModel.Tokens.Jwt.JwtSecurityToken("academia", "magazin",
[new Claim("unique_name", date.Utilizator)], expires: DateTime.UtcNow.AddHours(1),
signingCredentials: new SigningCredentials(cheie, SecurityAlgorithms.HmacSha256));
return Results.Ok(new { token = new System.IdentityModel.Tokens.Jwt.JwtSecurityTokenHandler().WriteToken(token) });
});
app.MapGet("/profil", (ClaimsPrincipal user) => $"Profilul lui {user.Identity!.Name}").RequireAuthorization();
app.Run();
public record Login(string Utilizator, string Parola);De ce merge
Semnătura tokenului era calculată cu cheia din configurare, dar verificată cu o altă cheie, scrisă în cod; rezultatul nu se potrivea și orice token era respins. Citind cheia din Jwt:Cheie în ambele locuri, validarea recalculează exact aceeași semnătură. Al doilea apel folosește tokenul obținut la login și primește 200.
Alte forme ale mesajului
WWW-Authenticate: Bearer error="invalid_token", error_description="The signature key was not found"Microsoft.IdentityModel.Tokens.SecurityTokenInvalidSignatureException: IDX10511: Signature validation failed.
Cum o eviți pe viitor
- Ține cheia JWT într-un singur loc de configurare (User Secrets local, vault sau variabile de mediu în producție).
- Folosește același cod (un serviciu
GeneratorToken) pentru citirea cheii la emitere și la validare. - Nu pune cheia în cod sau în Git.
- Activează logarea
Microsoft.AspNetCore.AuthenticationpeDebugcând depanezi un 401.
Întrebări frecvente
Pot citi conținutul tokenului ca să verific?
Da. Payload-ul e doar Base64Url, nu e criptat; îl poți decoda (de exemplu cu JwtSecurityTokenHandler.ReadJwtToken). Semnătura nu îți spune cheia, doar dacă se potrivește cu cea pe care o ai.
Care e diferența față de „The signature key was not found”?
Acel mesaj apare când tokenul cere o cheie anume (prin kid) pe care validarea nu o are, de exemplu după rotirea cheilor la un furnizor de identitate. „The signature is invalid” înseamnă că s-a încercat o cheie, dar semnătura nu corespunde.
Erori înrudite
401 Unauthorized cu antetul WWW-Authenticate: Bearer (fără token sau token trimis greșit) 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. System.ArgumentOutOfRangeException: IDX10720: Unable to create KeyedHashAlgorithm for algorithm 'HS256', the key size must be greater than: '256' bits, key has '128' bits. (Parameter 'keyBytes') Cheia simetrică folosită pentru HS256 e prea scurtă: trebuie să aibă cel puțin 256 de biți, adică 32 de octeți. Folosește o cheie secretă aleatoare de minim 32 de caractere ASCII (ideal generată și păstrată în configurare sau într-un vault). 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.
