Migrer une authentification et Identity vers ASP.NET Core 2.0

Article
11/06/2024

ASP.NET Core 2.0 dispose d’un nouveau modèle d’authentification et d’Identity qui simplifie la configuration à l’aide de services. Les applications ASP.NET Core 1.x qui utilisent l’authentification ou Identity peuvent être mises à jour pour utiliser le nouveau modèle, comme indiqué ci-dessous.

Mettre à jour les espaces de noms

Dans la version 1.x, des classes telles que IdentityRole et IdentityUser ont été trouvées dans l’espace de noms Microsoft.AspNetCore.Identity.EntityFrameworkCore.

Dans la version 2.0, l’espace de noms Microsoft.AspNetCore.Identity est devenu le nouveau home de plusieurs de ces classes. Avec le code Identity par défaut, les classes affectées incluent ApplicationUser et Startup. Ajustez vos instructions using pour résoudre les références affectées.

Middleware et services d’authentification

Dans les projets 1.x, l’authentification est configurée via un middleware. Une méthode de middleware est appelée pour chaque schéma d’authentification que vous souhaitez prendre en charge.

L’exemple 1.x suivant configure l’authentification Facebook avec Identity dans 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"]
    });
}

Dans les projets 2.0, l’authentification est configurée via des services. Chaque schéma d’authentification est inscrit dans la méthode ConfigureServices de Startup.cs. La méthode UseIdentity est remplacée par UseAuthentication.

L’exemple 2.0 suivant configure l’authentification Facebook avec Identity dans 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();
}

La méthode UseAuthentication ajoute un composant middleware d’authentification unique, qui est responsable de l’authentification automatique et de la gestion des requêtes d’authentification à distance. Il remplace tous les composants d’un middleware individuel par un composant unique d’un middleware commun.

Vous trouverez ci-dessous des instructions liées à la migration 2.0 pour chaque schéma d’authentification majeur.

Sélectionnez l’une des deux options ci-dessous, puis apportez les modifications nécessaires à Startup.cs :

Utiliser des cookies avec Identity
- Remplacez UseIdentity par UseAuthentication dans la méthode Configure :
```
app.UseAuthentication();
```
- Appelez la méthode AddIdentity dans la méthode ConfigureServices pour ajouter les services d’authentification cookie.
- Si vous le souhaitez, appelez la méthode ConfigureApplicationCookie ou la méthode ConfigureExternalCookie dans la méthode ConfigureServices pour modifier les paramètres d’Identity du cookie.
```
services.AddIdentity<ApplicationUser, IdentityRole>()
        .AddEntityFrameworkStores<ApplicationDbContext>()
        .AddDefaultTokenProviders();

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

Utiliser des cookies sans Identity

Remplacez l’appel de la méthode UseCookieAuthentication dans la méthode Configure par UseAuthentication :
```
app.UseAuthentication();
```

Appelez les méthodes AddAuthentication et AddCookie dans la méthode ConfigureServices :

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