ASP.NET Core Identity 系列之一
ASP.NET Core Identity提供给我们一组工具包和API，它能帮助我们应用程序创建授权和认证功能，也可以用它创建账户并使用用户名和密码进行登录，同时也提供了角色和角色管理功能。ASP.NET Core Identity使用SQL Server/第三方数据库存储用户名和密码，角色和配置数据
这系列中我们主要使用VS中自带的LocalDB作为演示，你也可以直接从官网上进行下载：https://learn.microsoft.com/en-us/sql/database-engine/configure-windows/sql-server-express-localdb?view=sql-server-ver16
1、创建项目
理解ASP.NET Core Identity最好的方法是通过一个项目学习，我们创建一个ASP.NET Core MVC 项目，名字叫Identity，接下来，我们将配置该项目并且安装必要的包
2、配置项目
安装下列NuGet包
Microsoft.AspNetCore.Identity.EntityFrameworkCore
Microsoft.EntityFrameworkCore.Design
Microsoft.EntityFrameworkCore.SqlServer
3、配置项目
在Program.cs类中添加认证和授权中间件，在app.UseRouting后面添加如下代码：
app.UseAuthentication();
app.UseAuthorization();
4、设置ASP.NET Core Identity
ASP.NET Core Identity整个设置过程包括创建新的Model类、配置更改、Controller和Action支持身份验证和授权的操作
User类
User类表示应用程序中的用户，这些用户数据存储在数据库中，User类继承自IdentityUser类，位于命名空间Microsoft.AspNetCore.Identity中，在Models文件夹下创建AppUser.cs类
namespace Identity.Models{
public class AppUser : IdentityUser{}
}
AppUser类没有包含任何方法，这是因为IdentityUser类中提供了一些用户属性像用户名，电子邮件，电话，密码hash值等
如果IdentityUser类不能满足你的要求，你可以在AppUser中添加自己定义的属性，我们会在后面介绍
IdentityUser 类定义如下常用属性：
|
名称 |
描述 |
|
Id |
用户唯一ID |
|
UserName |
用户名称 |
|
|
用户Email |
|
PasswordHash |
用户密码的Hash值 |
|
PhoneNumber |
用户电话号码 |
|
SecurityStamp |
当每次用户的数据修改时生成随机值 |
创建DataBase Context
DataBase Context类继承自IdentityDbContext<T>类，T表示User类，在应用程序中使用AppUser，IdentityDbContext通过使用Entity Framework Core和数据库进行交互
在Models文件夹下创建一个AppIdentityDbContext类并继承IdentityDbContext<AppUser>类，如下代码：
namespace Identity.Models{
public class AppIdentityDbContext: IdentityDbContext<AppUser>
{
public AppIdentityDbContext(DbContextOptions<AppIdentityDbContext> options):
base(options)
{ }
}
}
创建数据库字符串链接
ASP.NET Core Identity 数据库连接字符串包含数据库名，用户名，密码。通常存储在appsettings.json文件中，这个文件位于根目录下
项目已经包含了这个文件，添加下面配置在你的appsettings.json 文件中
"ConnectionStrings": {
"DefaultConnection": "Server=(localdb)\\MSSQLLocalDB;Database=IdentityDB;Trusted_Connection=True;MultipleActiveResultSets=true"
}
连接字符串中Server指定SQL Server的LocalDB，Database指定数据库名称IdentityDB，你也可以起个别的名字
Trusted_Connection 设置为ture，项目通过使用windows认证链接到数据库，因此我们不需要提供用户名和密码
MultipleActiveResultSets 该特性表示允许在单个连接中执行多个批处理，使SQL语句执行更快，因此我们将它设置成true，MultipleActiveResultSets=true
使用AddDbContext()方法添加AppIdentityDbContext类并且指定它使用SQL Server数据库，连接字符串通过配置文件中获取
builder.Services.AddDbContext<AppIdentityDbContext>(
options =>options.UseSqlServer(builder.Configuration["ConnectionStrings:DefaultConnection"])
);
5、添加ASP.NET Core Identity服务
现在我们配置一下ASP.NET Core Identity 相关服务，代码如下：
builder.Services.AddIdentity<AppUser, IdentityRole>().
AddEntityFrameworkStores<AppIdentityDbContext>().
AddDefaultTokenProviders();
-
AddIdentity方法的参数类型指定AppUser类和IdentityRole类
-
AddEntityFrameworkStores方法指定Identity使用EF Core作为存储和项目中使用AppIdentityContext作为DB Context
-
AddDefaultTokenProviders方法添加默认Token提供程序，针对重置密码，电话号码和邮件变更操作以及生成双因子认证的
token，这部分我们后面会介绍
我们前面添加了app.UseAuthentication()方法，经过这个方法的每个HTTP请求会将用户的凭据将添加到Cookie或URL中。这使得用户和他发送的HTTP请求就会产生关联。
6、使用EF Migration 命令创建Identity 数据库
现在我们使用Entity Framework Core Migration 命令来创建Identity数据库(我们使用第二种方式)
我们在程序包管理器控制台中运行Migration 命令， 你需要安装对应.NET Core CLI，通过下面命令可以安装:
dotnet tool install --global dotnet-ef
接下来我们需要进入 .csproj 项目文件所在的目录。我们在程序包管理器控制台中运行dir来查看当前所在目录。我们可以看到当前目录不是项目所在目录，而是Identity.sIn
项目文件位于Identity文件夹内，使用cd ./Identity 进入该文件 夹。我们再次运行dir命令，显示我们当前所在的目录是 Identity.csproj文件所在目录：
现在我们运行 EF Core Migration 命令
第一个命令：
dotnet ef migrations add InitDBCommand
上面的命令需要几秒钟完成，完成之后，我们可以在Migrations文件夹能看到生成的文件，文件中包含表的定义。
第二个命令：
dotnet ef database update
上面命令将创建数据库以及表，执行完成这个命令我们就可以看到我们表结构。
第二种方法我们可以不使用.NET Core CLI命令，微软给我提供了一个包Microsoft.EntityFrameworkCore.Tools。该包提供一些命令帮助我们生成数据库和表，在程序包管理控制台中运行如下两个命令:
Add-Migration InitDBCommand --创建Migration
Update-Database --将Migration 更新到数据库
7、ASP.NET Core Identity 数据库
我们查看一下刚才创建的数据库
注意：我们在Visual Studio 菜单找到视图菜单并且打开SQL Server 对象资源管理器
Identity 数据库总共有8张表，这些表包含用户记录，角色，Claims，token和登录次数详细信息等
我们看一下每张表的作用
- _EFMigrationsHistory – 包含了前面所有的Migration
- AspNetRoleClaims – 按照角色存储Claims
- AspNetRoles – 存储所有的角色
- AspNetUserClaims – 存储用户的Claims
- AspNetUserLogins –存储用户的登录次数
- AspNetUserRoles – 存储用户对应的角色
- AspNetUsers – 存储所有用户
-
AspNetUserTokens – 存储外部认证的token
总结
这节我们主要介绍了如何配置ASP.NET Core Identity，我们现在可以添加用户，管理用户，添加角色，添加用户到角色，用户认证，Identity可以帮助我们做很多工作，我们在下节继续介绍。
源代码地址：
https://github.com/bingbing-gui/Asp.Net-Core-Skill/tree/master/AspNetCore.Identity/Identity
