Migrar a autenticação e a Identity para o ASP.NET Core 2.0

Artigo
11/06/2024

O ASP.NET Core 2.0 tem um novo modelo para autenticação e Identity isso simplifica a configuração usando serviços. Os aplicativos de ASP.NET Core 1.x que usam autenticação ou Identity podem ser atualizados para usar o novo modelo, conforme descrito abaixo.

Atualizar namespaces

No 1.x, classes como IdentityRole e IdentityUser foram encontradas no namespace Microsoft.AspNetCore.Identity.EntityFrameworkCore.

Na versão 2.0, o namespace Microsoft.AspNetCore.Identity tornou-se a nova home de várias dessas classes. Com o código padrão Identity, as classes afetadas incluem ApplicationUser e Startup. Ajuste suas instruções using para resolver as referências afetadas.

Middleware e serviços de autenticação

Em projetos do 1.x, a autenticação é configurada por meio do middleware. Um método middleware é invocado para cada esquema de autenticação que você deseja dar suporte.

O exemplo do 1.x a seguir configura a autenticação do Facebook com Identity em 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"]
    });
}

Em projetos do 2.0, a autenticação é configurada por meio de serviços. Cada esquema de autenticação é registrado no método ConfigureServices de Startup.cs. O método UseIdentity é substituído por UseAuthentication.

O exemplo do 2.0.x a seguir configura a autenticação do Facebook com Identity em 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();
}

O método UseAuthentication adiciona um único componente de middleware de autenticação, que é responsável pela autenticação automática e pelo tratamento de solicitações de autenticação remota. Ele substitui todos os componentes de middleware individuais por um único componente de middleware comum.

As instruções de migração do 2.0 para cada esquema de autenticação principal estão descritas abaixo.

Selecione uma das duas opções abaixo e faça as alterações necessárias em Startup.cs:

Use cookies com Identity
- Substitua UseIdentity por UseAuthentication no método Configure:
```
app.UseAuthentication();
```
- Invoque o método AddIdentity no método ConfigureServices para adicionar os serviços de autenticação cookie.
- Opcionalmente, invoque o método ConfigureApplicationCookie ou ConfigureExternalCookie no método ConfigureServices para ajustar as configurações do Identitycookie.
```
services.AddIdentity<ApplicationUser, IdentityRole>()
        .AddEntityFrameworkStores<ApplicationDbContext>()
        .AddDefaultTokenProviders();

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

Use cookies sem Identity

Substitua a chamada de método UseCookieAuthentication no método Configure por UseAuthentication:
```
app.UseAuthentication();
```

Invoque os métodos AddAuthentication e AddCookie no 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";
        });