一、ASP.NET Core Identity概要

ASP.NET Core Identity的原理可以看ASP.NET Core 之 Identity 入门（一），讲的通俗易懂，这里主要通过示例使用ASP.NET Core Identity。

二、ASP.NET Core Identity示例

1、创建具有身份验证的 Web 应用

选择 " 文件" " > 新建 > 项目"。
选择“ASP.NET Core Web 应用程序”。将项目命名为 WebApp1 ，使其命名空间与项目下载相同。单击" 确定"。
选择 ASP.NET Core Web 应用程序，然后选择 " 更改身份验证"。
选择单个用户帐户，然后单击 "确定"。

2、项目结构

因为我们创建项目的时候选择了个人账户，所以默认是基于 Microsoft.EntityFrameworkCore 的 ORM 框架来操作数据库的。

（1） ApplicationDbContext文件解析

我们先打开【Data -> Migrations -> ApplicationDbContext】

using Microsoft.AspNetCore.Identity.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore;

namespace IdentityAuthentication.Data
{
    public class ApplicationDbContext : IdentityDbContext
    {
        public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options)
            : base(options)
        {
        }
    }
}

微软已经定义好了一个可扩展的 DbContext 对象，默认命名叫 ApplicationDbContext（名称可根据自己的需要进行更改）。这里面没有任何 DbSet 属性或者相关的 EntityTypeConfiguretion 配置，那它的表结构是怎样的呢？看下父类 IdentityDbContext ：

发现它集成了 IdentityDbContext 基类，还定义了泛型的类型，IdentityUser 和 IdentityRole 就是我们的实体了，一个是用户，一个是角色。但还是没有 DbSet 属性，所以我们接着看下泛型基类IdentityDbContext：

发现这里又做了一次封装，接着往下找：

终于看到了DbSet，所以当你在使用 ApplicationDbContext 时，你就可以对用户和角色以及相关的 DbSet 进行操作了。

（2）`Startup.cs文件`

ConfigureServices 中配置如下：

　　　　　public void ConfigureServices(IServiceCollection services)
        {
            #region 第一部分 EFCore服务注入
            //EFCore迁移 https://www.cnblogs.com/qtiger/p/14581446.html
            services.AddDbContext<ApplicationDbContext>(options => options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));
            //数据库异常捕获
            services.AddDatabaseDeveloperPageExceptionFilter();
            #endregion

            #region 第二部分 Identity服务注入
            services.AddDefaultIdentity<IdentityUser>(options => options.SignIn.RequireConfirmedAccount = true)
                .AddEntityFrameworkStores<ApplicationDbContext>();
            services.Configure<IdentityOptions>(options =>
            {
                // Password settings.
                //PasswordOptions 类 https://docs.microsoft.com/zh-cn/dotnet/api/microsoft.aspnetcore.identity.passwordoptions?view=aspnetcore-5.0
                options.Password.RequireDigit = true;//密码是否必须包含数字
                options.Password.RequireLowercase = true;//密码是否包含小写ASCII字符
                options.Password.RequireNonAlphanumeric = true;//密码是否必须非字母数字字符
                options.Password.RequireUppercase = true;//密码是否包含大写字母ASCII字符
                options.Password.RequiredLength = 6;//密码最小长度，默认6
                options.Password.RequiredUniqueChars = 1;//密码必须包含唯一字符的最小数目，默认1

                // Lockout settings.
                //LockoutOptions 类 https://docs.microsoft.com/zh-cn/dotnet/api/microsoft.aspnetcore.identity.lockoutoptions?view=aspnetcore-5.0
                options.Lockout.DefaultLockoutTimeSpan = TimeSpan.FromMinutes(5);//在 TimeSpan 发生锁定时用户被锁定的。 默认为5分钟。
                options.Lockout.MaxFailedAccessAttempts = 5;//在用户被锁定之前允许的失败访问尝试次数，假设已启用锁定。 默认值为5。
                options.Lockout.AllowedForNewUsers = true;//是否锁定新用户

                // User settings.
                // UserOptions 类 https://docs.microsoft.com/zh-cn/dotnet/api/microsoft.aspnetcore.identity.useroptions?view=aspnetcore-5.0
                options.User.AllowedUserNameCharacters =
                "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-._@+";//用于验证用户名的用户名中允许使用的字符的列表
                options.User.RequireUniqueEmail = false;//指示应用程序是否需要为其用户提供唯一的电子邮件
            });
            #endregion

            #region 第三部分 应用程序cookie配置
            //CookieAuthenticationOptions 类 https://docs.microsoft.com/zh-cn/dotnet/api/microsoft.aspnetcore.authentication.cookies.cookieauthenticationoptions?view=aspnetcore-5.0
            services.ConfigureApplicationCookie(options =>
            {
                // Cookie settings
                options.Cookie.HttpOnly = true;//确定浏览器是否应允许客户端 javascript 访问 cookie。 默认值为 true，这表示只将 Cookie 传递给 http 请求，而不可供页上的脚本使用。
                options.ExpireTimeSpan = TimeSpan.FromMinutes(5);//控制 cookie 中存储的身份验证票证从其创建的点保持有效的时间
                options.LoginPath = "/Identity/Account/Login";//如果为 LogoutPath 提供了处理程序，则对该路径的请求将基于 ReturnUrlParameter 进行重定向。
                options.AccessDeniedPath = "/Identity/Account/AccessDenied";//处理 ForbidAsync 时，重定向目标的处理程序使用 AccessDeniedPath 属性。
                options.SlidingExpiration = true;//SlidingExpiration 设置为 true，以指示处理程序在每次处理超过过期时段一半的请求时，使用新的过期时间重新颁发新的 cookie。
            });
            #endregion
            #region 第四部分 注入页面相关的服务
            services.AddRazorPages();
            #endregion
        }

先来看下第一部分EFCore迁移，因为该项目框架默认是基于 Microsoft.EntityFrameworkCore 的 ORM 框架来操作数据库的，所以需要注入EFCore相关的服务。
重点是第二部分Identity服务。AddDefaultIdentity 是在 ASP.NET Core 2.1 中引入的，注入认证相关的服务，向应用程序添加一组通用认证服务，包括默认 UI、令牌提供程序，并将身份验证配置为cookie。调用 AddDefaultIdentity 类似于调用以下内容：

　　AddEntityFrameworkStores表示添加认证信息存储的实体框架实现，即认证信息通过efcore存储。services.Configure<IdentityOptions>(options =>{})用于配置认证信息，上边代码中有详细的注释，这里就不说了。

第三部分是对cookie的设置，可以看下代码注释。
这里详细说下第四部分，在netcore项目中经常见到AddMvcCore，AddControllers，AddControllersWithViews，AddRazorPages，他们有什么不一样的吗？
- services.AddMvcCore() 只注册路由请求和执行控制器所必要的核心服务，确保 Pipeline 程序可运转。除非是有能力并想完全去自主DIY，一般不建议直接使用这个。
- services.AddControllers()除包含了 AddMvcCore() 所有功能，再加上：Authorization、ApiExplorer、Data Annotation、Formatter Mapping、CORS。要用 Controller 但不用View，新建WebAPI时，默认采用的就是这个，使用这个时，与SwashBuckle配合时，无需再额外引入ApiExplorer,自身已经依赖。
- services.AddRazorPages() 包含 AddMvcCore() 所有功能，再加上：Razor Pages、Authorization、Data Annotation、Cache Tag Helper
- services.AddControllersWithViews() 包含 AddControllers() 所有功能，再加上：cshtml和Razor View、Cache Tag Helper，标准MVC模式，常用Razor视图，使用这个就够了
- services.AddMvc() 包含 AddControllersWithViews() 及 AddRazorPages() 功能。包含的功能最为齐全，如果不想遗漏功能，直接使用这个就行

Configure中的配置：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
        app.UseMigrationsEndPoint();
    }
    else
    {
        app.UseExceptionHandler("/Error");
        app.UseHsts();
    }

    app.UseHttpsRedirection();
    app.UseStaticFiles();

    app.UseRouting();

    app.UseAuthentication();
    app.UseAuthorization();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapRazorPages();
    });
}

3、应用迁移

先在appsettings.json配置下数据库连接字符串：

{
  "ConnectionStrings": { "DefaultConnection": "Server=.;Database=DbIdentity;User ID=sa;Password=123456;" }, "Logging": { "LogLevel": { "Default": "Information", "Microsoft": "Warning", "Microsoft.Hosting.Lifetime": "Information" } }, "AllowedHosts": "*" }

在包管理器控制台中运行以下命令 (PMC) ：