学习 skoruba/ IdentityServer4.Admin 完整版

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

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

 skoruba/IdentityServer4.Admin ，本Blog仅描述使用后者的一些经验：

    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、主项目：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 的连接字符串，HelpersStartupHelpers.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 用户名、密码）