System.InvalidOperationException: No authenticationScheme was specified, and there was no DefaultChallengeScheme found. The default schemes can be set using either AddAuthentication(string defaultScheme) or AddAuthentication(Action<AuthenticationOptions> configureOptions).
Un endpoint protejat trebuie să ceară autentificarea (challenge), dar aplicația nu are nicio schemă implicită. Înregistrează autentificarea cu o schemă: AddAuthentication(JwtBearerDefaults.AuthenticationScheme).AddJwtBearer(...).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când o cerere fără utilizator ajunge la un endpoint cu [Authorize] sau RequireAuthorization(), middleware-ul de autorizare apelează ChallengeAsync: „cere-i clientului să se autentifice”. Pentru JWT, challenge-ul înseamnă 401 cu WWW-Authenticate: Bearer; pentru cookie-uri, redirect la pagina de login. Ca să știe ce să facă, are nevoie de o schemă de autentificare implicită pentru challenge.
Mesajul spune că nu există niciuna: fie lipsește complet AddAuthentication(...), fie ai apelat AddAuthentication() fără nume de schemă și fără niciun handler care să devină implicit, fie ai înregistrat handler-ul cu un nume (AddJwtBearer("Api", ...)), dar nu l-ai setat ca implicit.
Atenție: AddAuthorization() singur nu configurează autentificarea. Autorizarea decide dacă ai voie; autentificarea stabilește cine ești. Eroarea apare ca 500 la prima cerere neautentificată spre un endpoint protejat.
De ce apare: cauzele frecvente
1Lipsește înregistrarea autentificării
builder.Services.AddAuthorization();builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
.AddJwtBearer(o => o.TokenValidationParameters = new() { /* ... */ });
builder.Services.AddAuthorization();AddAuthentication(schema) setează schema implicită, iar AddJwtBearer înregistrează handler-ul ei.
2Schemă cu nume, dar fără implicită
builder.Services.AddAuthentication()
.AddJwtBearer("Api", o => { /* ... */ });builder.Services.AddAuthentication("Api")
.AddJwtBearer("Api", o => { /* ... */ });Numele dat lui AddAuthentication trebuie să fie același cu al handler-ului.
3Mai multe scheme
builder.Services.AddAuthentication()
.AddJwtBearer()
.AddCookie();builder.Services.AddAuthentication(o =>
{
o.DefaultScheme = JwtBearerDefaults.AuthenticationScheme;
o.DefaultChallengeScheme = JwtBearerDefaults.AuthenticationScheme;
}).AddJwtBearer().AddCookie();Cu mai multe handler-e, alegi explicit care face autentificarea și challenge-ul implicit.
Repară eroarea, direct în pagină
O cerere fără token la GET /profil primește 500 cu No authenticationScheme was specified, and there was no DefaultChallengeScheme found. Configurează autentificarea JWT (issuer academia, audience magazin, cheia o-cheie-secreta-de-cel-putin-32-de-octeti), ca cererea anonimă să primească 401, iar cea cu token 200.
using System.Security.Claims;
using System.Text;
using Microsoft.AspNetCore.Authentication.JwtBearer;
using Microsoft.IdentityModel.Tokens;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddAuthorization();
var app = builder.Build();
app.UseAuthentication();
app.UseAuthorization();
app.MapGet("/profil", (ClaimsPrincipal user) => $"Profilul lui {user.Identity!.Name}").RequireAuthorization();
app.Run();GET /profil → 401 Unauthorized WWW-Authenticate: Bearer GET /profil → 200 OK Profilul lui ana
Indiciu
Ai nevoie de AddAuthentication(JwtBearerDefaults.AuthenticationScheme).AddJwtBearer(...) cu TokenValidationParameters.
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")),
});
builder.Services.AddAuthorization();
var app = builder.Build();
app.UseAuthentication();
app.UseAuthorization();
app.MapGet("/profil", (ClaimsPrincipal user) => $"Profilul lui {user.Identity!.Name}").RequireAuthorization();
app.Run();De ce merge
Aplicația avea doar autorizare, fără nicio schemă de autentificare, deci la o cerere anonimă nu avea cine să facă challenge-ul. AddAuthentication(JwtBearerDefaults.AuthenticationScheme) setează JwtBearer ca schemă implicită, iar AddJwtBearer știe să valideze tokenurile și să răspundă cu 401 și WWW-Authenticate: Bearer. Cererea cu token valid primește 200.
Alte forme ale mesajului
System.InvalidOperationException: No authenticationScheme was specified, and there was no DefaultAuthenticateScheme found.
Cum o eviți pe viitor
- Înregistrează mereu autentificarea cu o schemă implicită:
AddAuthentication(JwtBearerDefaults.AuthenticationScheme). - Când ai mai multe scheme, setează explicit
DefaultScheme,DefaultChallengeSchemeșiDefaultForbidScheme. - Testează un endpoint protejat fără token: răspunsul corect e 401, nu 500.
- Rulează testele de integrare la fiecare modificare, ca problema să fie prinsă înainte de producție, nu raportată de utilizatori.
Întrebări frecvente
De ce .NET 7+ uneori merge fără schema în AddAuthentication()?
Din .NET 7, dacă e înregistrat un singur handler, el devine automat schema implicită. Cu zero handler-e (lipsește AddJwtBearer) sau cu mai multe, trebuie să alegi explicit.
Eroarea apare doar fără token. De ce?
Challenge-ul are loc doar când utilizatorul nu e autentificat. Cererile care nu ating endpoint-uri protejate nu au nevoie de schemă.
Erori înrudite
System.InvalidOperationException: No authenticationScheme was specified, and there was no DefaultForbidScheme found. The default schemes can be set using either AddAuthentication(string defaultScheme) or AddAuthentication(Action<AuthenticationOptions> configureOptions). Ai întors Results.Forbid() (sau Forbid() din controller) într-o aplicație fără schemă de autentificare. Forbid deleagă răspunsul 403 handler-ului de autentificare. Configurează autentificarea, sau, dacă nu ai, întoarce direct Results.StatusCode(403). 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. System.InvalidOperationException: The AuthorizationPolicy named: 'Majori' was not found. Endpoint-ul cere o politică de autorizare cu un nume (RequireAuthorization("Majori") sau [Authorize(Policy = "Majori")]) care nu a fost definită. Adaug-o în AddAuthorization(o => o.AddPolicy("Majori", ...)), cu exact același nume. Î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.
