Migración de la autenticación y Identity a ASP.NET Core 2.0

Artículo
11/06/2024

ASP.NET Core 2.0 tiene un nuevo modelo para la autenticación y Identity que simplifica la configuración mediante servicios. Las aplicaciones de ASP.NET Core 1.x que usen la autenticación o Identity se pueden actualizar para usar el nuevo modelo, tal y como se describe a continuación.

Actualizar espacios de nombres

Se encontraron clases en 1.x, como IdentityRole y IdentityUser, en el espacio de nombres Microsoft.AspNetCore.Identity.EntityFrameworkCore.

En la versión 2.0, el espacio de nombres Microsoft.AspNetCore.Identity se convirtió en el nuevo home de varias de estas clases. Con el código predeterminado Identity, las clases afectadas incluyen ApplicationUser y Startup. Ajuste las instrucciones using para resolver las referencias afectadas.

Servicios y middleware de autenticación

En los proyectos de 1.x, la autenticación se configura mediante middleware. Se invoca un método de middleware para cada esquema de autenticación que desee admitir.

En el ejemplo de 1.x siguiente se configura la autenticación de Facebook con Identity en 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"]
    });
}

En los proyectos de 2.0, la autenticación se configura a través de servicios. Cada esquema de autenticación se registra en el método ConfigureServices de Startup.cs. El método UseIdentity se reemplaza por UseAuthentication.

En el ejemplo de 2.0 siguiente se configura la autenticación de Facebook con Identity en 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();
}

El método UseAuthentication agrega un único componente de middleware de autenticación, que es responsable de la autenticación automática y del control de solicitudes de autenticación remota. Reemplaza todos los componentes de middleware individuales por un único componente de middleware común.

A continuación, se muestran las instrucciones de migración de 2.0 para cada esquema de autenticación principal.

Seleccione una de las dos opciones siguientes y realice los cambios necesarios en Startup.cs:

Uso de cookies con Identity
- Reemplace UseIdentity por UseAuthentication en el método Configure:
```
app.UseAuthentication();
```
- Invoque el método AddIdentity en el método ConfigureServices para agregar los servicios de autenticación cookie.
- Opcionalmente, invoque el método ConfigureApplicationCookie o ConfigureExternalCookie en el método ConfigureServices para ajustar la configuración de Identitycookie.
```
services.AddIdentity<ApplicationUser, IdentityRole>()
        .AddEntityFrameworkStores<ApplicationDbContext>()
        .AddDefaultTokenProviders();

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

Uso de cookies sin Identity

Reemplace la llamada de método UseCookieAuthentication en el método Configure por UseAuthentication:
```
app.UseAuthentication();
```

Invoque los métodos AddAuthentication y AddCookie en el método 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";
        });