学习 skoruba/ IdentityServer4.Admin 完整版

    想学习 IdentityServer4 的身份服务器的开发,但正好处于 Net Core 发布 3.0,各类框架处于升级中。git

 IdentityServer4 尽提供了基础的功能,界面UI 须要扩展,或者购买商业咨询服务。Github 有几个扩展的项目,其中两个处于持续的更新中,包括升级 Net Core 3.0,分别是:brunohbrito/JPProject.IdentityServer4.SSOgithub

 skoruba/IdentityServer4.Admin ,本Blog仅描述使用后者的一些经验:sql

    dentityServer4.Admin 的 Dev 版已升级 Net Core 3.0,Clone 整个源码在本地测试,过程记录:docker

    测试环境是:windows2012, VS2019 16.4, 没有安装 .Net 4.7.2 产生一个 Build Error : MSB3086 , 未能使用 SdkToolsPath, 或者 找到“al.exe”,安装后OK。shell

    1)因为源项目支持 Docker ,win2012 须要安装 Docker Tools ,麻烦,直接将“VS项目docker-compose” 卸载,不然有一些配置会提示。数据库

    2)同时也删除了主项目 STS.Identity 的 Docker 支持:launchSettings.json 的 Docker 启动项,项目根目录下的 Dockerfile。(项目要增长Docker支持,右健点项目,选‘添加/ Docker 支持...’,能够从新加上删除的两项信息。---- 新建 VS Core Web项目时,有支持 Docker 的可选项。)----- 仅是我的考虑。json

      整个解决方案须要设置三个启动项目:(右键点击 ’VS解决方案‘,选择 ’设置启动项目...‘ 菜单。)windows

  • Skoruba.IdentityServer4.STS.Identity
  • Skoruba.IdentityServer4.Admin
  • Skoruba.IdentityServer4.Admin.Api

一、主项目:Skoruba.IdentityServer4.STS.Identity    IdentityServer4 的扩展,能够单独启动。服务器

      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,是 or UsernameEmail 。

  User 用户自行注册,或者是统一注册。
 设置 设置电子邮件:SmtpConfiguration 或SendgridConfiguration。

二、公共项目: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

三、管理界面项目 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、修改启动程序  -> , 取消注释:
踩坑注意:单独启动主项目,自行注册了用户,会致使 初始种子用户 Admin 不会导入!,请删除注册的用户后,从新运行。估计是插入初始数据时,会判断数据库中是否已有数据,有就不插了)

B、初始数据,放在 appsettings.json 文件中,
IdentityServerData 节是:  与 
节是: Users (default admin 用户名、密码)Program.cs 文件MainDbMigrationHelpers.EnsureSeedData(host)ClientsResources;
IdentityData