学习 skoruba/ IdentityServer4.Admin 完整版
想学习 IdentityServer4 的身份服务器的开发,但正好处于 Net Core 发布 3.0,各种框架处于升级中。
IdentityServer4 尽提供了基础的功能,界面UI 需要扩展,或者购买商业咨询服务。Github 有几个扩展的项目,其中两个处于持续的更新中,包括升级 Net Core 3.0,分别是:brunohbrito/JPProject.IdentityServer4.SSO,
dentityServer4.Admin 的 Dev 版已升级 Net Core 3.0,Clone 整个源码在本地测试,过程记录:
测试环境是:windows2012, VS2019 16.4, 没有安装 .Net 4.7.2 产生一个 Build Error : MSB3086 , 未能使用 SdkToolsPath, 或者 找到“al.exe”,安装后OK。
1)由于源项目支持 Docker ,win2012 需要安装 Docker Tools ,麻烦,直接将“VS项目docker-compose” 卸载,否则有一些配置会提示。
2)同时也删除了主项目 STS.Identity 的 Docker 支持:launchSettings.json 的 Docker 启动项,项目根目录下的 Dockerfile。(项目要增加Docker支持,右健点项目,选‘添加/ Docker 支持...’,可以重新加上删除的两项信息。---- 新建 VS Core Web项目时,有支持 Docker 的可选项。)----- 仅是个人考虑。
整个解决方案需要设置三个启动项目:(右键点击 ’VS解决方案‘,选择 ’设置启动项目...‘ 菜单。)
- Skoruba.IdentityServer4.STS.Identity
- Skoruba.IdentityServer4.Admin
- Skoruba.IdentityServer4.Admin.Api
1.1)主项目依赖:Skoruba.IdentityServer4.Admin.EntityFramework
(依赖 Skoruba.IdentityServer4.Admin.EntityFramework.Extensions)
Skoruba.IdentityServer4.Admin.EntityFramework.Identity (依赖 Admin.EntityFramework)
Skoruba.IdentityServer4.Admin.EntityFramework.Shared (依赖 Admin.EntityFramework、Identity)
1.2)要真正能运行起来,重点是 EF Core 的配置,以及 数据迁移Migration 命令的运行。由于使用了EF框架,可以支持多种数据库:MSSQL、PostgreSQL, SQLite, MySQL等,但首先要安装相应的驱动。
Install-Package Microsoft.EntityFrameworkCore.SqlServer 支持 MSSQL Server, (坑之一)
特别提示,源项目的依赖中没有引入。否则 会在 Update-Database 应用 Migration时 出现Build错误。
默认使用:MSSQL Server 本地版,如果使用其它数据库,还需要修改 appsettings.json 的连接字符串,Helpers\StartupHelpers.cs 中的UseSqlServer、UseNpgsql、UseSqlite、UseMySql 等。
1.3)在VS 的 "包管理控制台",选择 STS.Identity 项目,运行下列四命令,Migrations for IdentityServer configuration DbContext 与 persisted grants DbContext:
Add-Migration IdentityServerConfigurationDbInit -context IdentityServerConfigurationDbContext -output Data/Migrations/IdentityServerConfiguration
Update-Database -context IdentityServerConfigurationDbContext
Add-Migration IdentityServerPersistedGrantsDbInit -context IdentityServerPersistedGrantDbContext -output Data/Migrations/IdentityServerGrants
Update-Database -context IdentityServerPersistedGrantDbContext
1.4)User Login Configuration/Register Configuration 配置,通过 appsettings.json
User login column 配置用户表中哪个列代表登录User,是Username
or Email 。
User 用户自行注册,或者是统一注册。
设置 设置电子邮件:SmtpConfiguration 或
SendgridConfiguration。
2、公共项目:Skoruba.IdentityServer4.Admin.EntityFramework.Shared
在VS 的 "包管理控制台",选择 EntityFramework.Shared 项目,运行 数据迁移命令:Migrations for Asp.Net Core Identity DbContext: 这是 用户及角色、权限有关的数据结构。
Add-Migration AspNetIdentityDbInit -context AdminIdentityDbContext -output Data/Migrations/Identity
Update-Database -context AdminIdentityDbContext
3、管理界面项目 Skoruba.IdentityServer4.Admin
3.1)在VS 的 "包管理控制台",选择 Skoruba.IdentityServer4.Admin 项目,运行 数据迁移命令:Migrations for Logging DbContext 与 Migrations for AuditLogging DbContext
Add-Migration LoggingDbInit -context AdminLogDbContext -output Data/Migrations/Logging
Update-Database -context AdminLogDbContext
Add-Migration AdminAuditLogDbInit -context AdminAuditLogDbContext -output Data/Migrations/AuditLogging
Update-Database -context AdminAuditLogDbContext
3.2)种子数据:
A、修改启动程序 Program.cs 文件
-> Main
, 取消注释:DbMigrationHelpers.EnsureSeedData(host)
(踩坑注意:单独启动主项目,自行注册了用户,会导致 初始种子用户 Admin 不会导入!,请删除注册的用户后,重新运行。估计是插入初始数据时,会判断数据库中是否已有数据,有就不插了)
B、初始数据,放在 appsettings.json 文件中,
IdentityServerData 节是: Clients
与 Resources;
IdentityData
节是: Users (default admin 用户名、密码)