...
Eroare ASP.NET Core · Autentificare, JWT, CORS și teste

WWW-Authenticate: Bearer error="invalid_token", error_description="The audience 'aplicatia-mobila' is invalid"

Pe scurt

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://magazin față de magazin);
  • 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

Greșit
C#
audience: "aplicatia-mobila"   // la login
ValidAudience = "magazin",     // la validare
Corect
C#
audience: 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

Greșit
C#
ValidAudience = "magazin",
Corect
C#
ValidAudiences = ["magazin", "aplicatia-mobila"],

Lista acceptă explicit toate audiențele legitime, fără să dezactivezi verificarea.

3Prefix api:// la furnizori externi

Greșit
C#
ValidAudience = "magazin",
Corect
C#
ValidAudience = "api://magazin",

Furnizori ca Entra ID pun în aud identificatorul aplicației exact cum e înregistrat.

Repară tu

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.

Codul care dă eroarea
C#
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);
După reparație, programul afișează
GET /profil → 200 OK
Profilul lui ana
Indiciu

TokenValidationParameters are și o proprietate pentru o listă de audiențe.

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 ValidAudiences când mai mulți clienți legitimi primesc tokenuri cu audiențe diferite.
  • Decodează tokenul și verifică aud câ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

← Toate erorile ASP.NET Core

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.