During this session, we are going to discuss ASP.NET Core Authentication and for this purpose, we use Entity Framework Core Identity. The process of determining a user’s identification is called authentication. The system links a set of identifying credentials to an incoming request. The submitted credentials are compared to those stored in a database on a local operating system or within an authentication server with information about the authorized user. During this tutorial we used Microsoft.AspNetCore.Identity.EntityFrameworkCore package to manage authentication, authorization, and user management.
What is Authentication?
The process of determining a user’s identification is called authentication. The system links a set of identifying credentials to an incoming request. The submitted credentials are compared to those stored in a database on a local operating system or within an authentication server with information about the authorized user.
Entity Framework Core Identity
To implement authentication, we need to use the Entity Framework Core Identity package and we need to install it through NuGet Package Manager. We discussed NuGet Packages during Session 45 and talked about upgrading the packages in Session 48.
The package that we need to install is Microsoft.AspNetCore.Identity.EntityFrameworkCore. Just bear in mind we need to install the version which is compatible with the installed EF Core version.
EF Core Identity Entities
To add the EF Core Identity entities, first, we need to modify our web app DB Context as you can see below.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
public class WebAppDBContext : IdentityDbContext { public WebAppDBContext(DbContextOptions<WebAppDBContext> options) : base(options) { } public DbSet<Category> Categories { get; set; } public DbSet<Cost> Costs { get; set; } protected override void OnModelCreating(ModelBuilder modelBuilder) { base.OnModelCreating(modelBuilder); modelBuilder.Seed(); } } |
As you can see, we inherited the DbContext class from IdentityDbContext and we added the base.OnModelCreating(modelBuilder) to the OnModelCreating method.
Then, we need to add Identity as a service in the Startup Class and ConfigureServices method.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
public void ConfigureServices(IServiceCollection services) { services.AddDbContextPool<WebAppDBContext> (options=> options.UseSqlServer(Configuration.GetConnectionString("CostDBConnectionSQLServer"))); services.AddIdentity<IdentityUser, IdentityRole>().AddEntityFrameworkStores<WebAppDBContext>(); services.AddControllersWithViews(); services.AddScoped<ICostRepository, SQLServerCostRepository>(); services.AddScoped<ICategoryRepository, SQLServerCategoryRepository>(); } |
Moreover, to add authentication to our web app we need to add Authentication middleware to Startup Class and Configure method.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(new DeveloperExceptionPageOptions { SourceCodeLineCount = 10 }); } else { //app.UseStatusCodePagesWithRedirects("/Error/{0}"); app.UseExceptionHandler("/Error"); app.UseStatusCodePagesWithReExecute("/Error/{0}"); } app.UseStaticFiles(); app.UseRouting(); app.UseAuthentication(); app.UseEndpoints(endpoints => { endpoints.MapDefaultControllerRoute(); }); } |
Now, we can add the EF Core Identity Entities to our database by running Add-Migration and Update-Database commands inside the Package Manager Console. If you need more information about the Package Manager Console watch Session 46 where we explained it in detail.
You can download this Session Slides form HERE.