Migrieren von Authentifizierung und Identity zu ASP.NET Core 2.0

Artikel
11/06/2024

ASP.NET Core 2.0 verfügt über ein neues Modell für die Authentifizierung und Identity, was die Konfiguration mithilfe von Diensten vereinfacht. ASP.NET Core 1.x-Anwendungen, die Authentifizierung verwenden oder Identity verwenden, können wie unten beschrieben aktualisiert werden, um das neue Modell zu verwenden.

Aktualisieren von Namespaces

In Version 1.x waren Klassen wie „IdentityRole“ und „IdentityUser“ im Namespace „Microsoft.AspNetCore.Identity.EntityFrameworkCore“ zu finden.

In Version 2.0 wurde der Microsoft.AspNetCore.Identity-Namespace zum neuen home mehrerer solcher Klassen. Mit dem Standardcode „Identity“ umfassen die betroffenen Klassen „ApplicationUser“ und „Startup“. Passen Sie Ihre „using“-Anweisungen an, um die betroffenen Verweise aufzulösen.

Middleware für Authentifizierung und Dienste

In 1.x-Projekten wird die Authentifizierung mithilfe von Middleware konfiguriert. Für jedes Authentifizierungsschema, das Sie unterstützen möchten, wird eine Middlewaremethode aufgerufen.

Im folgenden 1.x-Beispiel wird die Facebook-Authentifizierung mit „Identity“ in „Startup.cs“ konfiguriert:

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

In 2.0.x-Projekten wird die Authentifizierung mithilfe von Diensten konfiguriert. Jedes Authentifizierungsschema wird in der „ConfigureServices“-Methode von „Startup.cs“ registriert. Die „UseIdentity“-Methode wird durch „UseAuthentication“ ersetzt.

Im folgenden 2.0.x-Beispiel wird die Facebook-Authentifizierung mit „Identity“ in „Startup.cs“ konfiguriert:

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

Die „UseAuthentication“-Methode fügt eine einzelne Authentifizierungsmiddleware-Komponente hinzu, die für die automatische Authentifizierung und die Verarbeitung von Remote-Authentifizierungsanforderungen zuständig ist. Sie ersetzt alle individuellen durch eine einzelne, gemeinsame Middlewarekomponente.

Im Folgenden finden Sie 2.0-Migrationsanweisungen für jedes wichtige Authentifizierungsschema.

Wählen Sie eine der beiden folgenden Optionen aus, und nehmen Sie die erforderlichen Änderungen in „Startup.cs“ vor:

Verwenden von Cookies mit Identity
- Ersetzen Sie „UseIdentity“ in der „UseAuthentication“ -Methode durch „Configure“:
```
app.UseAuthentication();
```
- Rufen Sie die „AddIdentity“-Methode in der „ConfigureServices“-Methode auf, um die „cookie“-Authentifizierungsdienste hinzuzufügen.
- Rufen Sie optional die „ConfigureApplicationCookie“- oder „ConfigureExternalCookie“-Methode in der „ConfigureServices“-Methode auf, um die „Identitycookie“-Einstellungen zu optimieren.
```
services.AddIdentity<ApplicationUser, IdentityRole>()
        .AddEntityFrameworkStores<ApplicationDbContext>()
        .AddDefaultTokenProviders();

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

Verwenden von Cookies ohne Identity

Ersetzen Sie den Methodenaufruf „UseCookieAuthentication“ in der „Configure“-Methode durch „UseAuthentication“:
```
app.UseAuthentication();
```

Rufen Sie die „AddAuthentication“- und „AddCookie“-Methode in der „ConfigureServices“-Methode auf:

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