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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
IDX10214 este forma completă a erorii de audience, așa cum o aruncă JwtSecurityTokenHandler.ValidateToken (sau JsonWebTokenHandler.ValidateTokenAsync) când validezi manual un token, sau cum apare în logurile de Debug ale handler-ului JwtBearer. Spre deosebire de antetul HTTP, mesajul arată ambele părți ale comparației:
Audiences: 'magazin': ce scrie în claim-ulaudal tokenului;ValidAudience: 'api-magazin'șiValidAudiences: 'null': ce acceptă parametrii tăi.
Comparația e exactă, ca text. Validarea manuală apare în servicii care primesc tokenuri pe alte canale (SignalR, mesaje din coadă, webhook-uri) sau în teste; aici e ușor ca valorile să fie scrise de mână și să difere de cele de la emitere.
Soluția nu e ValidateAudience = false, ci aceeași sursă de configurare pentru ambele părți.
De ce apare: cauzele frecvente
1Valori diferite scrise de mână
new JwtSecurityToken("academia", "magazin", ...);
ValidAudience = "api-magazin",var aud = config["Jwt:Audience"];
new JwtSecurityToken("academia", aud, ...);
ValidAudience = aud,O singură sursă de configurare face valorile identice.
2Validarea dezactivată ca „reparație”
ValidateAudience = false,ValidAudiences = ["magazin", "aplicatia-mobila"],Lista de audiențe acceptate rezolvă cazurile legitime fără să slăbească securitatea.
Repară eroarea, direct în pagină
POST /verifica generează un token pentru audience-ul magazin și îl validează manual, dar răspunde 500 cu IDX10214: Audience validation failed. Repară parametrii de validare ca tokenul să fie acceptat și 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 cheie = 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(cheie, SecurityAlgorithms.HmacSha256));
var text = new JwtSecurityTokenHandler().WriteToken(token);
var parametri = new TokenValidationParameters
{
ValidIssuer = "academia",
ValidAudience = "api-magazin",
IssuerSigningKey = cheie
};
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
Compară audience-ul tokenului cu ValidAudience din parametri.
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 cheie = 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(cheie, SecurityAlgorithms.HmacSha256));
var text = new JwtSecurityTokenHandler().WriteToken(token);
var parametri = new TokenValidationParameters
{
ValidIssuer = "academia",
ValidAudience = "magazin",
IssuerSigningKey = cheie
};
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
Tokenul avea aud = magazin, iar TokenValidationParameters accepta doar api-magazin, deci ValidateToken arunca SecurityTokenInvalidAudienceException. Cu aceeași valoare la emitere și la validare, verificarea trece, iar principalul rezultat conține identificatorul utilizatorului, mapat la ClaimTypes.NameIdentifier. Validarea audience-ului rămâne activă și protejează API-ul de tokenuri emise pentru alte servicii.
Alte forme ale mesajului
IDX10208: Unable to validate audience. validationParameters.ValidAudience is null or whitespace and validationParameters.ValidAudiences is null.
Cum o eviți pe viitor
- Construiește
TokenValidationParametersîntr-un singur loc (o metodă sau un serviciu) și refolosește-l. - Citește issuer-ul și audience-ul din configurare.
- La validare manuală, prinde
SecurityTokenExceptionși răspunde 401, nu 500. - Rulează testele de integrare la fiecare modificare, ca problema să fie prinsă înainte de producție, nu raportată de utilizatori.
Întrebări frecvente
Ce e IDX10208?
Apare când nu ai setat deloc ValidAudience/ValidAudiences, dar validarea audience-ului e activă. Mesajul spune că nu are cu ce compara.
Antetul WWW-Authenticate spune același lucru?
Da, pe scurt: The audience 'magazin' is invalid. IDX10214 e versiunea detaliată, din excepție sau din log.
Erori înrudite
WWW-Authenticate: Bearer error="invalid_token", error_description="The audience 'aplicatia-mobila' is invalid" Claim-ul aud din token nu e în ValidAudience/ValidAudiences ale API-ului: tokenul a fost emis pentru alt destinatar. Emite tokenul cu audience-ul acestui API sau, dacă API-ul servește intenționat mai mulți clienți, listează toate valorile în ValidAudiences. 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.
