Hitelesítés és Identity migrálása az ASP.NET Core 2.0-ra.

2025-06-21

ASP.NET Core 2.0 egy új hitelesítési modellel rendelkezik, amely Identity leegyszerűsíti a konfigurációt a szolgáltatások használatával. Azok az ASP.NET Core 1.x alkalmazások, amelyek hitelesítést vagy Identity használnak, az alábbiakban leírtak szerint frissíthetők az új modell használatára.

Névterek frissítése

Az 1.x-ben ilyen IdentityRoleIdentityUser osztályok találhatók a Microsoft.AspNetCore.Identity.EntityFrameworkCore névtérben.

2.0-ban a Microsoft.AspNetCore.Identity névtér több ilyen osztály új otthonává vált. Az alapértelmezett Identity kóddal az érintett osztályok közé tartozik a ApplicationUser és a Startup. Módosítsa az using utasításokat az érintett hivatkozások feloldásához.

Hitelesítési köztes szoftver és szolgáltatások

Az 1.x-projektekben a hitelesítés köztes szoftveren keresztül van konfigurálva. A rendszer minden támogatni kívánt hitelesítési sémához meghív egy köztes szoftvermetódust.

A következő 1.x példa konfigurálja a Facebook-hitelesítést a Identity a Startup.cs:

public void ConfigureServices(IServiceCollection services)
{
    services.AddIdentity<ApplicationUser, IdentityRole>()
            .AddEntityFrameworkStores<ApplicationDbContext>();
}

public void Configure(IApplicationBuilder app, ILoggerFactory loggerfactory)
{
    app.UseIdentity();
    app.UseFacebookAuthentication(new FacebookOptions {
        AppId = Configuration["auth:facebook:appid"],
        AppSecret = Configuration["auth:facebook:appsecret"]
    });
}

A 2.0-s projektekben a hitelesítés szolgáltatásokon keresztül van konfigurálva. Minden hitelesítési séma regisztrálva van a ConfigureServices metódusban Startup.cs. A UseIdentity metódus helyébe UseAuthenticationa következő lép: .

A következő példa 2.0 konfigurálja a Facebook-hitelesítést IdentityStartup.cs segítségével.

public void ConfigureServices(IServiceCollection services)
{
    services.AddIdentity<ApplicationUser, IdentityRole>()
            .AddEntityFrameworkStores<ApplicationDbContext>();

    // If you want to tweak Identity cookies, they're no longer part of IdentityOptions.
    services.ConfigureApplicationCookie(options => options.LoginPath = "/Account/LogIn");
    services.AddAuthentication()
            .AddFacebook(options =>
            {
                options.AppId = Configuration["auth:facebook:appid"];
                options.AppSecret = Configuration["auth:facebook:appsecret"];
            });
}

public void Configure(IApplicationBuilder app, ILoggerFactory loggerfactory) {
    app.UseAuthentication();
}

A UseAuthentication metódus egyetlen hitelesítési köztes szoftverösszetevőt ad hozzá, amely az automatikus hitelesítésért és a távoli hitelesítési kérelmek kezeléséért felelős. Az összes köztes szoftverösszetevőt egyetlen, közös köztes szoftverösszetevőre cseréli.

Az alábbiakban 2.0-s migrálási utasításokat talál az egyes fő hitelesítési sémákhoz.

Válassza ki az alábbi két lehetőség egyikét, és végezze el a szükséges módosításokat a következőben Startup.cs:

Cookiek használata Identity
- Cserélje le UseIdentity a UseAuthentication következő metódusraConfigure:
```
app.UseAuthentication();
```
- AddIdentity A hitelesítési szolgáltatások hozzáadásához hívja meg a ConfigureServices metódus metódusátcookie.
- Igény szerint meghívhatja a ConfigureApplicationCookie metódust vagy ConfigureExternalCookie metódust a ConfigureServicesIdentitycookie beállítások finomhangolásához.
```
services.AddIdentity<ApplicationUser, IdentityRole>()
        .AddEntityFrameworkStores<ApplicationDbContext>()
        .AddDefaultTokenProviders();

services.ConfigureApplicationCookie(options => options.LoginPath = "/Account/LogIn");
```

Cookie-k használata Identity nélkül

Cserélje le a UseCookieAuthentication metódushívást a Configure metódusban a UseAuthentication metódusra.
```
app.UseAuthentication();
```

A AddAuthentication metódusban hívja meg a AddCookie és ConfigureServices metódusokat.

// If you don't want the cookie to be automatically authenticated and assigned to HttpContext.User,
// remove the CookieAuthenticationDefaults.AuthenticationScheme parameter passed to AddAuthentication.
services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme)
        .AddCookie(options =>
        {
            options.LoginPath = "/Account/LogIn";
            options.LogoutPath = "/Account/LogOff";
        });