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

WWW-Authenticate: Bearer error="invalid_token", error_description="The token expired at '11/04/2026 10:15:00'"

Pe scurt

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 de UtcNow pe un server cu alt fus orar, sau ceasurile serverelor nesincronizate.

De ce apare: cauzele frecvente

1Dată de expirare fixă, rămasă din dezvoltare

Greșit
C#
expires: new DateTime(2025, 12, 31, 0, 0, 0, DateTimeKind.Utc)
Corect
C#
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)

Greșit
C#
var durata = config.GetValue<int>("Jwt:DurataMinut"); // cheia e DurataMinute
Corect
C#
var durata = config.GetValue<int>("Jwt:DurataMinute");

GetValue<int> întoarce 0 pentru o cheie inexistentă, deci tokenul expiră practic la emitere.

3Unități confundate

Greșit
C#
expires: DateTime.UtcNow.AddSeconds(60) // voiai 60 de minute
Corect
C#
expires: 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

Greșit
C#
// aplicația folosește același token la nesfârșit
Corect
C#
// 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ă tu

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.

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

Folosește DateTime.UtcNow.AddMinutes(durata) pentru expires.

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ă exp din DateTime.UtcNow, cu durata citită cu GetValue<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 ValidateLifetime ca 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

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