Migrowanie uwierzytelniania i Identity do ASP.NET Core 2.0

Artykuł
11/30/2023

ASP.NET Core 2.0 ma nowy model uwierzytelniania i Identity upraszcza konfigurację przy użyciu usług. ASP.NET aplikacje core 1.x korzystające z uwierzytelniania lub Identity można je zaktualizować, aby korzystać z nowego modelu, jak opisano poniżej.

Aktualizowanie przestrzeni nazw

W wersji 1.x klasy takie IdentityRole i IdentityUser zostały znalezione w Microsoft.AspNetCore.Identity.EntityFrameworkCore przestrzeni nazw.

W wersji 2.0 Microsoft.AspNetCore.Identity przestrzeń nazw stała się nowym domem dla kilku takich klas. W przypadku domyślnego Identity kodu klasy, których dotyczy problem, obejmują ApplicationUser i Startup. Dostosuj instrukcje using , aby rozwiązać problemy z odwołaniami, których dotyczy problem.

Oprogramowanie pośredniczące uwierzytelniania i usługi

W projektach 1.x uwierzytelnianie jest konfigurowane za pośrednictwem oprogramowania pośredniczącego. Metoda oprogramowania pośredniczącego jest wywoływana dla każdego schematu uwierzytelniania, który chcesz obsługiwać.

Poniższy przykład w wersji 1.x umożliwia skonfigurowanie uwierzytelniania serwisu Facebook za pomocą Identity polecenia w programie :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"]
    });
}

W projektach 2.0 uwierzytelnianie jest konfigurowane za pośrednictwem usług. Każdy schemat uwierzytelniania jest zarejestrowany w ConfigureServices metodzie Startup.cs. Metoda UseIdentity jest zastępowana ciągiem UseAuthentication.

Poniższy przykład 2.0 umożliwia skonfigurowanie uwierzytelniania w usłudze Facebook za pomocą Identity polecenia w programie :Startup.cs

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();
}

Metoda UseAuthentication dodaje pojedynczy składnik oprogramowania pośredniczącego uwierzytelniania, który jest odpowiedzialny za automatyczne uwierzytelnianie i obsługę żądań uwierzytelniania zdalnego. Zastępuje on wszystkie poszczególne składniki oprogramowania pośredniczącego jednym, typowym składnikiem oprogramowania pośredniczącego.

Poniżej przedstawiono instrukcje migracji 2.0 dla każdego głównego schematu uwierzytelniania.

Wybierz jedną z dwóch poniższych opcji i wprowadź niezbędne zmiany w pliku Startup.cs:

Używanie funkcji cookies z Identity
- Zastąp UseIdentity ciąg ciągiem UseAuthentication w metodzie Configure :
```
app.UseAuthentication();
```
- Wywołaj metodę AddIdentity w metodzie ConfigureServices , aby dodać cookie usługi uwierzytelniania.
- Opcjonalnie wywołaj metodę ConfigureApplicationCookie or ConfigureExternalCookie w metodzie ConfigureServices , aby dostosować Identitycookie ustawienia.
```
services.AddIdentity<ApplicationUser, IdentityRole>()
        .AddEntityFrameworkStores<ApplicationDbContext>()
        .AddDefaultTokenProviders();

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

Używanie cookies bez Identity

Zastąp UseCookieAuthentication wywołanie metody w metodzie Configure ciągiem UseAuthentication:
```
app.UseAuthentication();
```

Wywołaj AddAuthentication metody i w metodzie ConfigureServices :AddCookie

// 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";
        });