ASP.NET Core Identity 学习笔记（一）
ASP.NET Core Identity 是一个身份验证的框架，本篇文章根据官方文档的介绍，进行初步的实践，为一个ASP.NET Core Web应用添加一个默认的实现。并尝试分别使用SQLite，Sql Server和Mysql作为持久化的数据库。具体的Identity术语可以参考官方文档，本文章便不再过多阐述。
文档参考：
ASP.NET Core 简介 Identity
IdentityASP.NET Core 项目中的基架
基架 Identity 到没有现有授权的 MVC 项目
https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql/commit/8cb800389af08b6cc091844b8519dc53d4de8662#diff-8c29e7d21446c5ca06e3ec06c3360ab1R36
Specified key was too long; max key length is 767 bytes #1526
Specified key was too long; max key length is 767 bytes #81
ASP.NET Identity：将 MySQL 存储用于 EntityFramework MySQL 提供程序（C#）
一、新建一个ASP.NET Core Web应用程序
身份验证选择不进行身份验证，这个我们后面进行添加。项目类型选择了Web应用程序（模型视图控制器），也就是MVC项目。创建完成后的文件结构如图所示。
创建完成之后是一个普通的web项目，没有身份验证，只有几个简单的页面，添加一个控制器及视图来设置为需要经过身份验证才能访问的。
AdminController.cs
using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc;
namespace IdentityDemo.Controllers
{
[Authorize]
public class AdminController : Controller
{
public IActionResult Index()
{
return View();
}
}
}
/Views/Admin/Index.cshtml
@{
ViewData["Title"] = "Index";
}
Admin Index
在AdminController上添加[Authorize]注解表示访问这个控制器的所有方法需要身份验证。添加了控制器的文件结构如下所示：
二、添加Identity基架（SQLite/Sql Server/MySQL）
在项目上右击选择 添加-新搭建基架的项目
选择标识（Identity）,点击添加。
选择布局页，这个是MVC项目，则我选择/Views/Shared/_Layout.cshtml。
勾选上替代所有文件，这会帮助我们创建所有关于Identity会用到的页面。
数据上下类，点击右面的加号，新创建一个。当勾选“使用SQLite而不是SQL Server”时，会使用SQLite作为持久化数据库，否则默认使用SQL Server作为持久化数据库。
用户类，这边选择新建一个，点击右侧加号新建。
然后点击添加。如果在添加的途中发生如下报错的时候，点击确定，然后重新点击添加完成操作。
完成以后的项目结构大致如图所示
三、对代码做几处修改
/Views/Shared/_Layout.cshtml
@ViewData["Title"] - IdentityDemo
@RenderBody()
@RenderSection("Scripts", required: false)
Startup.cs
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
namespace IdentityDemo
{
public class Startup
{
public Startup(IConfiguration configuration)
{
Configuration = configuration;
}
public IConfiguration Configuration { get; }
// This method gets called by the runtime. Use this method to add services to the container.
public void ConfigureServices(IServiceCollection services)
{
services.AddControllersWithViews();
+ services.AddRazorPages();
}
// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
else
{
app.UseExceptionHandler("/Home/Error");
// The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
app.UseHsts();
}
app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseRouting();
+ app.UseAuthentication();
app.UseAuthorization();
app.UseEndpoints(endpoints =>
{
endpoints.MapControllerRoute(
name: "default",
pattern: "{controller=Home}/{action=Index}/{id?}");
+ endpoints.MapRazorPages();
});
}
}
}
四、初始化数据库
修改配置文件appsettings.json中的连接字符串到自己的数据库。然后打开 工具-NuGet包管理器-程序包管理器控制台。
执行以下三条命令
Install-Package Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore Add-Migration CreateIdentitySchema Update-Database
执行完成之后可以看到数据库里的表已经创建好了。
此时可以调试运行项目欣赏一下成果。
注册页面
登录界面
没有登录的时候点击Admin也会跳转到登录界面
五、使用Mysql数据库
使用mysql数据库时在以上基础上要对代码做一些修改
修改数据库连接字符串为连接Mysql的连接字符串
修改使用的连接字符串
使用NuGet安装包MySql.Data.EntityFrameworkCore
Install-Package MySql.Data.EntityFrameworkCore
IdentityHostingStartup.cs
using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using WebAdmin.Areas.Identity.Data;
using WebAdmin.Data;
[assembly: HostingStartup(typeof(WebAdmin.Areas.Identity.IdentityHostingStartup))]
namespace WebAdmin.Areas.Identity
{
public class IdentityHostingStartup : IHostingStartup
{
public void Configure(IWebHostBuilder builder)
{
builder.ConfigureServices((context, services) => {
services.AddDbContext(options =>
+ options.UseMySQL(
+ context.Configuration.GetConnectionString("WebAdminMysqlContextConnection")));
services.AddDefaultIdentity(options => options.SignIn.RequireConfirmedAccount = true)
.AddEntityFrameworkStores();
});
}
}
}
手动创建数据库，字符集CharSet选择utf8mb4
还需要手动创建表__EFMigrationsHistory。如果不做这一步，有可能不会自动创建数据表，提示表不存在。
CREATE TABLE `__EFMigrationsHistory`
(
`MigrationId` nvarchar(150) NOT NULL,
`ProductVersion` nvarchar(32) NOT NULL,
PRIMARY KEY(`MigrationId`)
);
修改一下数据库表模型的索引的长度。如果不做这一步，可能会导致以下报错：Specified key was too long; max key length is 3072 bytes，如果数据选的utf8字符集，则会是 767 bytes。
/Areas/Identity/Data/xxxContext.cs
using IdentityDemo.Areas.Identity.Data;
using Microsoft.AspNetCore.Identity;
using Microsoft.AspNetCore.Identity.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore;
namespace IdentityDemo.Data
{
public class IdentityDemoContext : IdentityDbContext
{
public IdentityDemoContext(DbContextOptions options)
: base(options)
{
}
protected override void OnModelCreating(ModelBuilder builder)
{
+ builder.Entity(entity => entity.Property(m => m.Id).HasMaxLength(127));
+ builder.Entity(entity => entity.Property(m => m.Id).HasMaxLength(127));
+ builder.Entity>(entity => entity.Property(m => m.LoginProvider).HasMaxLength(127));
+ builder.Entity>(entity => entity.Property(m => m.ProviderKey).HasMaxLength(127));
+ builder.Entity>(entity => entity.Property(m => m.UserId).HasMaxLength(127));
+ builder.Entity>(entity => entity.Property(m => m.RoleId).HasMaxLength(127));
+ builder.Entity>(entity => entity.Property(m => m.UserId).HasMaxLength(127));
+ builder.Entity>(entity => entity.Property(m => m.LoginProvider).HasMaxLength(127));
+ builder.Entity>(entity => entity.Property(m => m.Name).HasMaxLength(127));
base.OnModelCreating(builder);
}
}
}
删除在上面生成的Migrations文件夹，重新执行一下迁移的步骤
Add-Migration CreateIdentitySchema Update-Database
执行完以上的步骤后，则可以看到数据库中Identity相关的表已经建好了
以上就是使用不同的数据库来开始使用Identity。
后面会持续更新Identity的学习笔记。