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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
IDX10511 apare când validarea a încercat cheile disponibile (Keys tried: ...), dar semnătura nu se potrivește cu niciuna. Este echivalentul detaliat al lui The signature is invalid din antetul HTTP. Variantele înrudite: IDX10503 (în versiunile mai vechi ale bibliotecii) și IDX10500/IDX10501 (nicio cheie configurată, respectiv nicio cheie cu kid-ul cerut de token).
Pentru HS256, cheia de validare trebuie să fie exact aceiași octeți ca la semnare. Diferențe frecvente:
- texte diferite (o cheie în cod, alta în configurare);
- același text, dar encoding diferit (
UTF8față deASCII, sau Base64 decodat într-o parte și folosit ca text în cealaltă); - spații sau rânduri noi la finalul valorii citite din fișier sau variabilă de mediu.
Pentru RS256 (furnizori ca Entra ID, Auth0, Keycloak), validarea folosește cheia publică a furnizorului; cu Authority setat, cheile sunt descărcate și reîmprospătate automat.
De ce apare: cauzele frecvente
1Chei diferite
var cheieLogin = ...GetBytes("o-cheie-secreta-de-cel-putin-32-de-octeti");
IssuerSigningKey = ...GetBytes("alta-cheie-secreta-de-cel-putin-32-octeti")IssuerSigningKey = cheieLoginAceeași cheie (același obiect sau aceeași valoare din configurare) la semnare și la validare.
2Spațiu sau rând nou în valoare
var cheie = File.ReadAllText("cheie.txt");var cheie = File.ReadAllText("cheie.txt").Trim();Un \n la final schimbă octeții cheii și, deci, semnătura.
3Base64 tratat ca text
Encoding.UTF8.GetBytes(config["Jwt:CheieBase64"]!)Convert.FromBase64String(config["Jwt:CheieBase64"]!)O cheie salvată ca Base64 trebuie decodată la fel în ambele locuri.
Repară eroarea, direct în pagină
POST /verifica semnează un token cu cheieLogin, apoi îl validează cu o altă cheie și răspunde 500 cu IDX10511: Signature validation failed. Repară validarea ca să folosească aceeași cheie, iar răspunsul să fie Token valid pentru ana.
using System.Security.Claims;
using System.Text;
using Microsoft.AspNetCore.Authentication.JwtBearer;
using Microsoft.IdentityModel.Tokens;
using System.IdentityModel.Tokens.Jwt;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapPost("/verifica", (CerereToken c) =>
{
var cheieLogin = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("o-cheie-secreta-de-cel-putin-32-de-octeti"));
var token = new JwtSecurityToken("academia", "magazin", [new Claim("sub", "ana")],
expires: new DateTime(2099, 1, 1, 0, 0, 0, DateTimeKind.Utc),
signingCredentials: new SigningCredentials(cheieLogin, SecurityAlgorithms.HmacSha256));
var text = new JwtSecurityTokenHandler().WriteToken(token);
var parametri = new TokenValidationParameters
{
ValidIssuer = "academia",
ValidAudience = "magazin",
IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("alta-cheie-secreta-de-cel-putin-32-octeti"))
};
var utilizator = new JwtSecurityTokenHandler().ValidateToken(text, parametri, out _);
return $"Token valid pentru {utilizator.FindFirstValue(ClaimTypes.NameIdentifier)}";
});
app.Run();
public record CerereToken(string Antet);POST /verifica → 200 OK Token valid pentru ana
Indiciu
IssuerSigningKey trebuie să fie chiar cheia folosită la semnare.
Reparația
using System.Security.Claims;
using System.Text;
using Microsoft.AspNetCore.Authentication.JwtBearer;
using Microsoft.IdentityModel.Tokens;
using System.IdentityModel.Tokens.Jwt;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapPost("/verifica", (CerereToken c) =>
{
var cheieLogin = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("o-cheie-secreta-de-cel-putin-32-de-octeti"));
var token = new JwtSecurityToken("academia", "magazin", [new Claim("sub", "ana")],
expires: new DateTime(2099, 1, 1, 0, 0, 0, DateTimeKind.Utc),
signingCredentials: new SigningCredentials(cheieLogin, SecurityAlgorithms.HmacSha256));
var text = new JwtSecurityTokenHandler().WriteToken(token);
var parametri = new TokenValidationParameters
{
ValidIssuer = "academia",
ValidAudience = "magazin",
IssuerSigningKey = cheieLogin
};
var utilizator = new JwtSecurityTokenHandler().ValidateToken(text, parametri, out _);
return $"Token valid pentru {utilizator.FindFirstValue(ClaimTypes.NameIdentifier)}";
});
app.Run();
public record CerereToken(string Antet);De ce merge
Semnătura HMAC se poate verifica doar cu aceiași octeți folosiți la semnare. Parametrii foloseau o cheie diferită, deci toate încercările eșuau cu IDX10511. Cu IssuerSigningKey = cheieLogin, semnătura se potrivește, iar celelalte verificări (issuer, audience, expirare în 2099) trec și ele.
Alte forme ale mesajului
IDX10503: Signature validation failed. Token does not have a kid. Keys tried: 'Microsoft.IdentityModel.Tokens.SymmetricSecurityKey'.IDX10500: Signature validation failed. No security keys were provided to validate the signature.
Cum o eviți pe viitor
- Păstrează cheia într-un singur loc de configurare și citește-o prin același cod la semnare și la validare.
- Aplică
Trim()valorilor citite din fișiere sau variabile de mediu. - Pentru furnizori externi, folosește
Authorityîn loc de chei copiate manual. - Nu loga cheia când depanezi; loghează doar lungimea și o amprentă (hash).
Întrebări frecvente
Ce înseamnă Keys tried?
Lista tipurilor de chei încercate. Dacă e goală, nu ai configurat nicio cheie (IDX10500). Dacă apare cheia ta și tot eșuează, cheia e greșită.
Pot vedea ce cheie a fost folosită la semnare?
Nu din token: semnătura nu dezvăluie cheia. Poți vedea doar algoritmul (alg) și, eventual, identificatorul cheii (kid) din antet.
Erori înrudite
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. 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.SecurityTokenInvalidAudienceException: IDX10214: Audience validation failed. Audiences: 'magazin'. Did not match: validationParameters.ValidAudience: 'api-magazin' or validationParameters.ValidAudiences: 'null'. ValidateToken a găsit în token audience-ul magazin, dar parametrii de validare acceptă altă valoare (api-magazin). Folosește aceeași valoare la emitere și la validare, din configurare, sau listează toate audiențele legitime în ValidAudiences. Î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.
