WWW-Authenticate: Bearer error="invalid_token", error_description="The token expired at '11/04/2026 10:15:00'"
Tokenul JWT a expirat: ora din claim-ul exp e în trecut. Clientul trebuie să facă din nou login sau să folosească un refresh token. Dacă tokenurile expiră imediat după emitere, verifică durata la generare (unități, chei de configurare) și ceasul serverelor.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Fiecare JWT are de obicei claim-ul exp (expiration time): momentul, în secunde UTC, după care tokenul nu mai e valid. Handler-ul JwtBearer verifică această valoare (ValidateLifetime = true, implicit) și, dacă a trecut, răspunde 401 cu error_description="The token expired at '...'", cu data expirării în UTC.
Implicit, validarea tolerează o diferență de ceas de 5 minute (ClockSkew), deci un token e respins abia la 5 minute după exp. Mulți setează ClockSkew = TimeSpan.Zero ca expirarea să fie exactă.
Două situații diferite:
- expirare normală: utilizatorul a stat logat mai mult decât durata tokenului. E comportamentul dorit; clientul trebuie să ceară un token nou (login sau refresh token);
- expirare imediată: tokenurile sunt respinse chiar după login. Cauza e la generare: durata citită greșit din configurare (cheie greșită, deci 0), unități confundate (secunde în loc de minute),
DateTime.Nowîn loc deUtcNowpe un server cu alt fus orar, sau ceasurile serverelor nesincronizate.
De ce apare: cauzele frecvente
1Dată de expirare fixă, rămasă din dezvoltare
expires: new DateTime(2025, 12, 31, 0, 0, 0, DateTimeKind.Utc)var durata = config.GetValue<int>("Jwt:DurataMinute");
expires: DateTime.UtcNow.AddMinutes(durata)O dată fixă funcționează până trece, apoi toate tokenurile se nasc expirate. Expirarea se calculează mereu relativ la momentul emiterii.
2Durata citită cu o cheie greșită (0 minute)
var durata = config.GetValue<int>("Jwt:DurataMinut"); // cheia e DurataMinutevar durata = config.GetValue<int>("Jwt:DurataMinute");GetValue<int> întoarce 0 pentru o cheie inexistentă, deci tokenul expiră practic la emitere.
3Unități confundate
expires: DateTime.UtcNow.AddSeconds(60) // voiai 60 de minuteexpires: DateTime.UtcNow.AddMinutes(60)Un token de 60 de secunde expiră înainte ca utilizatorul să termine o acțiune.
4Clientul nu reînnoiește tokenul
// aplicația folosește același token la nesfârșit// la 401 cu „token expired”, cere un token nou
// (refresh token) și repetă cererea o singură datăExpirarea e o măsură de securitate; clientul trebuie să o trateze, nu serverul să o elimine.
Repară eroarea, direct în pagină
Imediat după login, GET /profil răspunde 401 cu error_description="The token expired at '12/31/2025 00:00:00'". Loginul folosește o dată de expirare fixă, rămasă din dezvoltare. Calculează expirarea ca acum (UTC) plus durata în minute din Jwt:DurataMinute (variabila durata e deja citită), ca tokenul nou să fie acceptat.
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")),
ClockSkew = TimeSpan.Zero,
});
builder.Services.AddAuthorization();
var app = builder.Build();
app.UseAuthentication();
app.UseAuthorization();
var durata = app.Configuration.GetValue<int>("Jwt:DurataMinute");
// TODO: expirarea e fixată la dezvoltare
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", "magazin",
[new Claim("unique_name", date.Utilizator)], expires: new DateTime(2025, 12, 31, 0, 0, 0, DateTimeKind.Utc),
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
Folosește DateTime.UtcNow.AddMinutes(durata) pentru expires.
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",
ValidAudience = "magazin",
IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("o-cheie-secreta-de-cel-putin-32-de-octeti")),
ClockSkew = TimeSpan.Zero,
});
builder.Services.AddAuthorization();
var app = builder.Build();
app.UseAuthentication();
app.UseAuthorization();
var durata = app.Configuration.GetValue<int>("Jwt:DurataMinute");
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", "magazin",
[new Claim("unique_name", date.Utilizator)], expires: DateTime.UtcNow.AddMinutes(durata),
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
Data fixă 31 decembrie 2025 era deja în trecut, deci orice token emis avea exp expirat, iar validarea (cu ClockSkew = TimeSpan.Zero) îl respingea. Calculată relativ la momentul emiterii, cu durata de 60 de minute din configurare, expirarea e în viitor, iar cererea cu tokenul proaspăt primește 200.
Alte forme ale mesajului
IDX10223: Lifetime validation failed. The token is expired. ValidTo (UTC): '11/04/2026 10:15:00', Current time (UTC): '11/04/2026 10:20:31'.
Cum o eviți pe viitor
- Generează
expdinDateTime.UtcNow, cu durata citită cuGetValue<int>(cheie, valoareImplicita)sau validată cu Options. - Ține tokenurile de acces scurte (minute) și folosește refresh tokens pentru sesiuni lungi.
- Sincronizează ceasul serverelor (NTP).
- Nu dezactiva
ValidateLifetimeca să scapi de eroare.
Întrebări frecvente
De ce un token expirat acum 3 minute încă merge?
Din cauza ClockSkew, implicit 5 minute, care tolerează diferențele de ceas dintre serverul care emite și cel care validează. Setează-l mai mic dacă ai nevoie de expirare exactă.
De ce data din mesaj e cu 2-3 ore diferită de ora mea?
Data e în UTC. România e în UTC+2 iarna și UTC+3 vara.
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. 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ă. 401 Unauthorized cu antetul WWW-Authenticate: Bearer (fără token sau token trimis greșit) Endpoint-ul cere un utilizator autentificat, iar cererea nu are un token valid în antetul Authorization. Trimite antetul exact în forma Authorization: Bearer <token> (cu cuvântul Bearer și un spațiu), fără ghilimele în jurul tokenului. Î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.
