Migrasikan autentikasi dan Identity ke ASP.NET Core 2.0

Artikel
11/06/2024

ASP.NET Core 2.0 memiliki model baru untuk autentikasi dan Identity yang menyederhanakan konfigurasi dengan menggunakan layanan. ASP.NET aplikasi Core 1.x yang menggunakan autentikasi atau Identity dapat diperbarui untuk menggunakan model baru seperti yang diuraikan di bawah ini.

Memperbarui namespace layanan

Dalam 1.x, kelas seperti IdentityRole itu dan IdentityUser ditemukan di Microsoft.AspNetCore.Identity.EntityFrameworkCore namespace layanan.

Pada 2.0, Microsoft.AspNetCore.Identity namespace menjadi yang baru home untuk beberapa kelas tersebut. Dengan kode default Identity , kelas yang terpengaruh termasuk ApplicationUser dan Startup. Sesuaikan pernyataan Anda using untuk menyelesaikan referensi yang terpengaruh.

Middleware dan layanan Autentikasi

Dalam proyek 1.x, autentikasi dikonfigurasi melalui middleware. Metode middleware dipanggil untuk setiap skema autentikasi yang ingin Anda dukung.

Contoh 1.x berikut mengonfigurasi autentikasi Facebook dengan Identity di 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"]
    });
}

Dalam proyek 2.0, autentikasi dikonfigurasi melalui layanan. Setiap skema autentikasi terdaftar dalam ConfigureServices metode Startup.cs. Metode UseIdentity ini diganti dengan UseAuthentication.

Contoh 2.0 berikut mengonfigurasi autentikasi Facebook dengan Identity di 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();
}

Metode ini UseAuthentication menambahkan satu komponen middleware autentikasi, yang bertanggung jawab atas autentikasi otomatis dan penanganan permintaan autentikasi jarak jauh. Ini menggantikan semua komponen middleware individual dengan satu komponen middleware umum.

Di bawah ini adalah instruksi migrasi 2.0 untuk setiap skema autentikasi utama.

Pilih salah satu dari dua opsi di bawah ini, dan buat perubahan yang diperlukan di Startup.cs:

Menggunakan cookie dengan Identity
- Ganti UseIdentity dengan UseAuthentication dalam Configure metode :
```
app.UseAuthentication();
```
- Panggil AddIdentity metode dalam ConfigureServices metode untuk menambahkan cookie layanan autentikasi.
- Secara opsional, panggil ConfigureApplicationCookie metode atau ConfigureExternalCookie dalam ConfigureServices metode untuk mengubah Identitycookie pengaturan.
```
services.AddIdentity<ApplicationUser, IdentityRole>()
        .AddEntityFrameworkStores<ApplicationDbContext>()
        .AddDefaultTokenProviders();

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

Menggunakan cookie tanpa Identity

UseCookieAuthentication Ganti panggilan metode dalam Configure metode dengan UseAuthentication:
```
app.UseAuthentication();
```

Panggil AddAuthentication metode dan AddCookie dalam ConfigureServices metode :

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