Migrera autentisering och Identity till ASP.NET Core 2.0

2025-05-05

ASP.NET Core 2.0 har en ny modell för autentisering och Identity som förenklar konfigurationen med hjälp av tjänster. ASP.NET Core 1.x-program som använder autentisering eller Identity kan uppdateras för att använda den nya modellen enligt beskrivningen nedan.

Uppdatera namnområden

I 1.x hittades klasser som sådana IdentityRole och IdentityUser i Microsoft.AspNetCore.Identity.EntityFrameworkCore namnområdet.

I 2.0 Microsoft.AspNetCore.Identity blev namnområdet det nya hemmet för flera av dessa klasser. Med standardkoden Identity inkluderas de berörda klasserna, inklusive ApplicationUser och Startup. Justera dina using instruktioner för att lösa de berörda referenserna.

Mellanprogram och tjänster för autentisering

I 1.x-projekt konfigureras autentiseringen via mellanprogram. En mellanprogramsmetod anropas för varje autentiseringsschema som du vill stödja.

Följande 1.x-exempel konfigurerar Facebook-autentisering med Identity i 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"]
    });
}

I 2.0-projekt konfigureras autentisering via tjänster. Varje autentiseringsschema registreras i ConfigureServices metoden Startup.cs. Metoden UseIdentity ersätts med UseAuthentication.

I följande 2.0-exempel konfigureras Facebook-autentisering med Identity i 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();
}

Metoden UseAuthentication lägger till en enda autentiseringskomponent för mellanprogram, som ansvarar för automatisk autentisering och hantering av fjärrautentiseringsbegäranden. Den ersätter alla enskilda mellanprogramskomponenter med en enda gemensam mellanprogramskomponent.

Nedan visas 2.0-migreringsinstruktioner för varje större autentiseringsschema.

Välj ett av de två alternativen nedan och gör de nödvändiga ändringarna i Startup.cs:

Använd cookies med Identity
- Ersätt UseIdentity med UseAuthentication i Configure -metoden:
```
app.UseAuthentication();
```
- Anropa AddIdentity-metoden i ConfigureServices-metoden för att lägga till cookie-autentiseringstjänster.
- Du kan också anropa ConfigureApplicationCookie metoden eller ConfigureExternalCookie i ConfigureServices metoden för att justera Identitycookie inställningarna.
```
services.AddIdentity<ApplicationUser, IdentityRole>()
        .AddEntityFrameworkStores<ApplicationDbContext>()
        .AddDefaultTokenProviders();

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

Använd cookies utan Identity

Ersätt metodanropet UseCookieAuthenticationConfigure i metoden med UseAuthentication:
```
app.UseAuthentication();
```

Anropa AddAuthentication- och AddCookie-metoderna i ConfigureServices-metoden:

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