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

WWW-Authenticate: Bearer error="invalid_token", error_description="The signature is invalid"

Pe scurt

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 (UTF8 față de ASCII sau 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

Greșit
C#
var cheieLogin = "cheia-serviciului-de-login-de-minim-32-octeti";
// ...
IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("alta-cheie-...")),
Corect
C#
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

Greșit
C#
Encoding.ASCII.GetBytes(cheie)    // la login
Encoding.UTF8.GetBytes(cheie)     // la validare
Corect
C#
Encoding.UTF8.GetBytes(cheie)     // în ambele locuri

Pentru caractere non-ASCII (de exemplu diacritice), octeții diferă, deci și semnătura.

3Token emis de alt mediu

Greșit
C#
// token copiat din staging, folosit pe local
Corect
C#
// generează tokenul pe același mediu
// sau folosește aceeași cheie doar intenționat

Fiecare mediu ar trebui să aibă cheia lui; un token din staging nu e valid în producție, și e bine așa.

Repară tu

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.

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("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);
După reparație, programul afișează
GET /profil → 200 OK
Profilul lui ana
Indiciu

Citește cheia cu builder.Configuration["Jwt:Cheie"] și folosește-o în IssuerSigningKey.

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.Authentication pe Debug câ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

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