Asp.net core 学习笔记之 authen + autho + oidc + oauth + spa 第二篇 (Introduction, Scaffold, Overview)

1. Introduction to Identity

https://docs.microsoft.com/en-us/aspnet/core/security/authentication/identity?view=aspnetcore-5.0&tabs=visual-studio

dotnet new webapp --auth Individual -uld -o WebApp1

new webapp 是做一个 razor page

--auth Individual 就是表示要包含 identity

-uld 是 use local database (本地数据库, 默认是用 SQLite)

-o WebApp1 是 output 项目名字

运行上面 command 后, 所有代码就写好了. 它是搭配 ef core 的哦. 接下来就是通过 ef migration 创建数据库了

dotnet ef database update

接着在 private 页面放上 authorize 标签就可以跑了

有一个小 point 要记入, app.UseAuthentication 的位置蛮重要的,

2. Scaffold Identity

https://docs.microsoft.com/en-us/aspnet/core/security/authentication/scaffold-identity?view=aspnetcore-5.0&tabs=netcore-cli#full

之所以几行 command 就可以跑是因为微软对 identity 做了一个封装, 这个封装还包括了 view (这个技术叫 Razor Class Library 简称 RCL)

我们来从一个 webapp 没有 authentication 的做起.

先装好 global 工具

dotnet tool install -g dotnet-aspnet-codegenerator

// 做一个新项目, 没有 authentication 的
dotnet new webapp -o ScaffoldIdentity

// 进入项目 folder
cd ScaffoldIdentity

// 装 package
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design
dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet add package Microsoft.AspNetCore.Identity.EntityFrameworkCore
dotnet add package Microsoft.AspNetCore.Identity.UI
dotnet add package Microsoft.EntityFrameworkCore.SqlServer
dotnet add package Microsoft.EntityFrameworkCore.Tools

// generate identity code template
dotnet aspnet-codegenerator identity --useDefaultUI

// 做数据库
dotnet ef migrations add CreateIdentitySchema
dotnet ef database update

跑完上面的 command 后, 在 startup 添加 UseAuthentication

然后在 layout view 添加, 就可以了

当然这个只是演示让我们知道它是怎样 work 起来的, 真实开发还是差很多的. 之后慢慢讲.

这里有几个 point 可以记入一下.

有一个 file IdentityHostingStartup.cs, 里面封装了 service 的调用, 所以我们在 startup 看不到,

然后所有的 view 都是看不见 source code 的.

除非在我们声明时加入 --files 或者拿掉 --useDefaultUI 那么所有的 source code 才会显示出来 (这正是我们需要的, 不然怎么魔改呢 ?)

3. Identity Overview

既然 Scaffold 帮我们搞了这么多代码, 那我们一个一个来看看 identity 框架的代码时如何工作得。要魔改自然要先摸清楚咯.

首先是 database entity

public class ScaffoldIdentityIdentityDbContext : IdentityDbContext<IdentityUser>
{
    public ScaffoldIdentityIdentityDbContext(DbContextOptions<ScaffoldIdentityIdentityDbContext> options)
        : base(options)
    {
    }

    protected override void OnModelCreating(ModelBuilder builder)
    {
        base.OnModelCreating(builder);
    }
}

可以看到就是把平常得 DbContext 继承了 IdentityDbContext

Identity 封装了许多得 model, 比如 IdentityUser, IdentityRole 等等啦.

有了这些, 数据库就搞定了.

接下来就是 Startup 的 service provide

services.AddDefaultIdentity<IdentityUser>(options => options.SignIn.RequireConfirmedAccount = true)
    .AddEntityFrameworkStores<ScaffoldIdentityIdentityDbContext>();

完整源码去这里下载 https://github.com/dotnet/aspnetcore/tree/main/src/Identity

2 年前我超讨厌看 .net 源码的, 东一个西一个, 幸好现在全部放一起了.

这里的源码需要稍微看一下，因为大部分情况我们是需要修改的.

AddDefaultIdentity

https://github.com/dotnet/aspnetcore/blob/main/src/Identity/UI/src/IdentityServiceCollectionUIExtensions.cs

services.AddAuthentication 是 asp.net core authentication 的 service 来的哦

AddIdentityCookies

https://github.com/dotnet/aspnetcore/blob/main/src/Identity/Core/src/IdentityCookiesBuilderExtensions.cs

里面负责了 cookie schemes 的代码

AddIdentityCore

https://github.com/dotnet/aspnetcore/blob/main/src/Identity/Extensions.Core/src/IdentityServiceCollectionExtensions.cs

负责UserManger 之类的