C# Web开发教程(九)标识框架[Identity]

标识(Identity)框架

• Authentication和Authorization

- Authentication: 认证,你是谁
- Authorization: 权限,你有什么权限

• 1、标识（Identity）框架: 采用基于角色(Role)的访问控制

- (Role-Based Access Control，简称RBAC）策略，内置了对用户、角色等表的管理以及相关的接口，支持外部登录、2FA等。
- 标识框架使用EF Core对数据库进行操作，因此标识框架支持几乎所有数据库。

• Identity框架使用

    - IdentityUser<TKey>、IdentityRole<TKey>，TKey代表主键的类型。我们一般编写继承自ldentityUser<TKey>、IdentityRole<TKey>等的自定义类，可以增加自定义属性。- NuGet安装: - Install-Package Microsoft.EntityFrameworkCore -Version 6.0.0- Install-Package Microsoft.EntityFrameworkCore.SqlServer -Version 6.0.0- Install-Package Microsoft.EntityFrameworkCore.Tools -Version 6.0.0- Install-Package Microsoft.AspNetCore.Identity.EntityFrameworkCore  -Version 6.0.0- 创建继承自ldentityDbContext的类- 可以通过ldDbContext类来操作数据库，不过框架中提供了RoleManager、UserManager等类来简化对数据库的操作。- 部分方法的返回值为Task<IdentityResult>类型

// MyUser.csusing Microsoft.AspNetCore.Identity;namespace WebApplicationAboutIdentity
{// 默认的 IdentityUser 使用 string 类型主键，这里改为 longpublic class MyUser:IdentityUser<long>{}
}// MyRole.cs
using Microsoft.AspNetCore.Identity;namespace WebApplicationAboutIdentity
{public class MyRole:IdentityRole<long>{}
}// MyDbContext.csusing Microsoft.AspNetCore.Identity;
using Microsoft.AspNetCore.Identity.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore;namespace WebApplicationAboutIdentity
{// 继承 IdentityDbContext，指定自定义的用户类型、角色类型和主键类型// 会自动创建 Identity 相关的所有表（Users、Roles、UserRoles 等）public class MyDbContext : IdentityDbContext<MyUser,MyRole,long>{public MyDbContext(DbContextOptions<MyDbContext> options) : base(options){}}
}// DbContextDesignTimeFactory.csusing Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Design;namespace WebApplicationAboutIdentity
{public class DbContextDesignTimeFactory: IDesignTimeDbContextFactory<MyDbContext>{public MyDbContext CreateDbContext(string[] args){// 配置数据库连接，用于 EF Core 迁移命令DbContextOptionsBuilder<MyDbContext> builder = new DbContextOptionsBuilder<MyDbContext>();string connStr = "Server=.;Database=idtest1;Trusted_Connection=True;";builder.UseSqlServer(connStr);MyDbContext ctx = new MyDbContext(builder.Options);return ctx;}}
}// Program.cs......
using Microsoft.AspNetCore.Identity;
using Microsoft.EntityFrameworkCore;
using WebApplicationAboutIdentity;var builder = WebApplication.CreateBuilder(args);
......// 数据库配置
builder.Services.AddDbContext<MyDbContext>(opt =>
{opt.UseSqlServer("Server=.;Database=idtest1;Trusted_Connection=True;");
});
// Identity 配置
builder.Services.AddDataProtection();
builder.Services.AddIdentityCore<MyUser>(options =>
{// 简化密码策略options.Password.RequireDigit = false;options.Password.RequiredLength = 6;options.Password.RequireLowercase = false;options.Password.RequireNonAlphanumeric = false;options.Password.RequireUppercase = false;// 设置令牌提供程序options.Tokens.PasswordResetTokenProvider = TokenOptions.DefaultEmailProvider;options.Tokens.EmailConfirmationTokenProvider = TokenOptions.DefaultEmailProvider;
});
// Identity 构建器
// 指定用户和角色类型,配置使用 Entity Framework 存储,添加默认令牌提供程序,注册用户管理器和角色管理器
IdentityBuilder idBuilder = new(typeof(MyUser),typeof(MyRole),builder.Services);
idBuilder.AddEntityFrameworkStores<MyDbContext>().AddDefaultTokenProviders().AddUserManager<UserManager<MyUser>>().AddRoleManager<RoleManager<MyRole>>();var app = builder.Build();
......app.Run();- 最后,作数据库迁移并更新数据库

• 小结:这个配置为应用程序提供了完整的用户认证和授权基础架构

- 自定义主键类型: 使用 long 代替默认的 string
- 简化的密码策略: 降低了密码复杂度要求
- 完整的 Identity 功能: 包含用户管理、角色管理、令牌生成等
- SQL Server 存储: 使用 Entity Framework Core 和 SQL Server