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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Claim-ul aud (audience) spune pentru cine a fost emis tokenul, de obicei identificatorul API-ului care îl va primi. Un API verifică faptul că tokenul i-a fost destinat lui, nu altui serviciu: altfel, un token obținut pentru serviciul de rapoarte ar putea fi folosit și pe API-ul de plăți, dacă împart aceeași cheie sau același furnizor de identitate.
Mesajul arată valoarea din token ('aplicatia-mobila'), care nu se regăsește în ValidAudience sau ValidAudiences. Cauze frecvente:
- emiterea folosește alt text decât validarea (inclusiv diferențe ca
api://magazinfață demagazin); - clientul cere tokenul pentru alt scope/resursă la furnizorul de identitate;
- un API nou acceptă tokenuri pentru mai multe aplicații, dar e configurat doar cu una.
Ca la issuer, nu dezactiva verificarea (ValidateAudience = false): e o protecție reală între servicii.
De ce apare: cauzele frecvente
1Text diferit la emitere și la validare
audience: "aplicatia-mobila" // la login
ValidAudience = "magazin", // la validareaudience: config["Jwt:Audience"]
ValidAudience = config["Jwt:Audience"],Aceeași valoare din configurare în ambele locuri.
2API folosit intenționat de mai mulți clienți
ValidAudience = "magazin",ValidAudiences = ["magazin", "aplicatia-mobila"],Lista acceptă explicit toate audiențele legitime, fără să dezactivezi verificarea.
3Prefix api:// la furnizori externi
ValidAudience = "magazin",ValidAudience = "api://magazin",Furnizori ca Entra ID pun în aud identificatorul aplicației exact cum e înregistrat.
Repară eroarea, direct în pagină
Tokenurile emise pentru aplicația mobilă (audience aplicatia-mobila) primesc 401 cu error_description="The audience 'aplicatia-mobila' is invalid". API-ul trebuie să accepte intenționat atât audience-ul magazin, cât și aplicatia-mobila. Repară validarea fără să dezactivezi verificarea audience-ului.
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("o-cheie-secreta-de-cel-putin-32-de-octeti")),
});
builder.Services.AddAuthorization();
var app = builder.Build();
app.UseAuthentication();
app.UseAuthorization();
app.MapPost("/login", (Login date) =>
{
var cheie = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("o-cheie-secreta-de-cel-putin-32-de-octeti"));
var token = new System.IdentityModel.Tokens.Jwt.JwtSecurityToken("academia", "aplicatia-mobila",
[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
TokenValidationParameters are și o proprietate pentru o listă de audiențe.
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",
ValidAudiences = ["magazin", "aplicatia-mobila"],
IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("o-cheie-secreta-de-cel-putin-32-de-octeti")),
});
builder.Services.AddAuthorization();
var app = builder.Build();
app.UseAuthentication();
app.UseAuthorization();
app.MapPost("/login", (Login date) =>
{
var cheie = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("o-cheie-secreta-de-cel-putin-32-de-octeti"));
var token = new System.IdentityModel.Tokens.Jwt.JwtSecurityToken("academia", "aplicatia-mobila",
[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
Tokenul avea aud = aplicatia-mobila, iar validarea accepta doar magazin. ValidAudiences = ["magazin", "aplicatia-mobila"] acceptă explicit ambii clienți legitimi și păstrează protecția: un token emis pentru alt serviciu e respins în continuare. Cererea cu tokenul de la login primește acum 200.
Alte forme ale mesajului
IDX10214: Audience validation failed. Audiences: 'aplicatia-mobila'. Did not match: validationParameters.ValidAudience: 'magazin' or validationParameters.ValidAudiences: 'null'.
Cum o eviți pe viitor
- Definește audience-ul fiecărui API o singură dată, în configurare.
- Folosește
ValidAudiencescând mai mulți clienți legitimi primesc tokenuri cu audiențe diferite. - Decodează tokenul și verifică
audcând depanezi un 401. - Rulează testele de integrare la fiecare modificare, ca problema să fie prinsă înainte de producție, nu raportată de utilizatori.
Întrebări frecvente
Care e diferența dintre issuer și audience?
Issuer-ul spune cine a emis tokenul (serverul de login), audience-ul spune cui îi e destinat (API-ul). Un API verifică ambele: că tokenul vine de la cine trebuie și că e pentru el.
Un token poate avea mai multe audiențe?
Da, aud poate fi o listă. Validarea trece dacă măcar una dintre valori se află în ValidAudience/ValidAudiences.
Erori înrudite
WWW-Authenticate: Bearer error="invalid_token", error_description="The issuer 'https://academia.ro' is invalid" Claim-ul iss din token nu e egal cu ValidIssuer (sau ValidIssuers) din TokenValidationParameters. Folosește exact aceeași valoare, citită din configurare, la emiterea tokenului și la validare; diferențele de un caracter (http/https, slash final) contează. 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.
