認證授權：IdentityServer4 - 數據持久化

認證授權：IdentityServer4 – 數據持久化

2020 年 10 月 6 日
筆記
IdentityServer4, 授權, 認證

前言：

　　前面的文章中IdentityServer4 配置內容都存儲到記憶體中，本篇文章開始把配置資訊存儲到資料庫中；本篇文章繼續基於github的程式碼來實現配置數據持久化到MySQL中

一、基於EFCore持久化IdentityServer數據

　1、資料庫上下文(DbContext )

　　　在前面使用IDS4時，配置的一些基礎：如Api資源、客戶端等數據；以及在使用過程中授權後發放的token、授權、授權碼等操作數據。如果持久化如何處理呢？IDS4已經提供了對應的方式

- ConfigurationDbContext

　　　　　　主要負責資料庫對客戶端、標識資源、Api資源和CORS等的配置存儲

- PersistedGrantDbContext

　　　　　　主要存儲操作數據，如：授權碼、訪問令牌、刷新令牌等相關操作數據

　2、在cz.IdentityServer中添加Nuget包：IdentityServer4.EntityFramework以及EF相關包

Install-Package IdentityServer4.EntityFramework

Install-Package Microsoft.EntityFrameworkCore

Install-Package Microsoft.EntityFrameworkCore.Tools

Install-Package Microsoft.EntityFrameworkCore.Design

Install-Package Pomelo.EntityFrameworkCore.MySql

　3、修改Startup文件中ConfigureServices方法中IdentityServer4配置內容如下：

public class Startup
{

    private IConfiguration _configuration;
    public Startup(IConfiguration configuration)
    {
        _configuration = configuration;
    }

    // This method gets called by the runtime. Use this method to add services to the container.
    // For more information on how to configure your application, visit //go.microsoft.com/fwlink/?LinkID=398940
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddControllersWithViews();

        services.Configure<CookiePolicyOptions>(options =>
        {
            options.MinimumSameSitePolicy = SameSiteMode.Strict;
        });
　　　　　//獲取連接串
        string connString = _configuration.GetConnectionString("Default");
　　　　 string migrationsAssembly = Assembly.GetEntryAssembly().GetName().Name;
        //添加IdentityServer服務
        services.AddIdentityServer()
            //添加這配置數據(客戶端、資源)
            .AddConfigurationStore(opt =>
            {
                opt.ConfigureDbContext = c =>
                {
                    c.UseMySql(connString, sql => sql.MigrationsAssembly(migrationsAssembly));
                };
            })
            //添加操作數據(codes、tokens、consents)
            .AddOperationalStore(opt =>
            {
                opt.ConfigureDbContext = c =>
                {
                    c.UseMySql(connString, sql => sql.MigrationsAssembly(migrationsAssembly));
                };
                //token自動清理
                opt.EnableTokenCleanup = true;
                ////token自動清理間隔：默認1H
                //opt.TokenCleanupInterval=3600;
                ////token自動清理每次數量
                //opt.TokenCleanupBatchSize = 100;
            })
　　　　　　　 //用戶默認依舊採用記憶體用戶，可用Identity替換
　　　　　　　.AddTestUsers(InMemoryConfig.Users().ToList());
    }

    // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
　　　　  //初始化數據(內容後面描述)
　　　　　SeedData.InitData(app);

if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }

        app.UseRouting();

        app.UseStaticFiles();
        app.UseCookiePolicy();
        app.UseIdentityServer();

        app.UseAuthentication();
        //使用默認UI，必須添加
        app.UseAuthorization();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapControllerRoute(name: "default", pattern: "{controller=Home}/{action=Index}/{id?}");
        });
    }
}

　4、遷移數據

　　遷移方式有多種方式：

　　1、打開包控制台，執行以下命令：

1 add-migration InitialPersistedGrantDb -c PersistedGrantDbContext -o Migrations/IdentityServer/PersistedGrantDb 
2 add-migration InitialConfigurationDb -c ConfigurationDbContext -o Migrations/IdentityServer/ConfigurationDb
3 update-database -c PersistedGrantDbContext   
4 update-database -c ConfigurationDbContext

　 2、在項目路徑中執行命令行：

1 dotnet ef migrations add InitialPersistedGrantDb -c PersistedGrantDbContext -o Migrations/IdentityServer/PersistedGrantDb
2 dotnet ef migrations add InitialConfigurationDb -c ConfigurationDbContext -o Migrations/IdentityServer/ConfigurationDb
3 dotnet ef database update -c PersistedGrantDbContext 
4 dotnet ef database update -c ConfigurationDbContext

二、數據表含義

　　 數據結構遷移完成我們來看下創建了那些表：

　　根據不同的資料庫上下文劃分如下圖：

三、初始化數據

　　1、創建文件SeedData.cs文件用於初始化基礎數據：

public class SeedData
{
    public static void InitData(IApplicationBuilder serviceProvider)
    {
        Console.WriteLine("開始創建初始化數據...");
        using (var scope = serviceProvider.ApplicationServices.CreateScope())
        {
            scope.ServiceProvider.GetRequiredService<PersistedGrantDbContext>().Database.Migrate();
            {
                var context = scope.ServiceProvider.GetRequiredService<ConfigurationDbContext>();
                context.Database.Migrate();
                EnsureSeedData(context);
            }
        }
        Console.WriteLine("初始化數據創建完成.");
    }

    private static void EnsureSeedData(ConfigurationDbContext context)
    {
        if (!context.Clients.Any())
        {
            Console.WriteLine("Clients 正在初始化");
            foreach (var client in InMemoryConfig.GetClients())
            {
                context.Clients.Add(client.ToEntity());
            }
            context.SaveChanges();
        }

        if (!context.IdentityResources.Any())
        {
            Console.WriteLine("IdentityResources 正在初始化");
            foreach (var resource in InMemoryConfig.GetIdentityResources())
            {
                context.IdentityResources.Add(resource.ToEntity());
            }
            context.SaveChanges();
        }

        if (!context.ApiResources.Any())
        {
            Console.WriteLine("ApiResources 正在初始化");
            foreach (var resource in InMemoryConfig.GetApiResources())
            {
                context.ApiResources.Add(resource.ToEntity());
            }
            context.SaveChanges();
        }

        if (!context.ApiScopes.Any())
        {
            Console.WriteLine("ApiScopes 正在初始化");
            foreach (var resource in InMemoryConfig.GetApiScopes())
            {
                context.ApiScopes.Add(resource.ToEntity());
            }
            context.SaveChanges();
        }
    }
}

　　2、並在Startup文件中添加：

 //初始化數據(內容後面描述)
SeedData.InitData(app);

　　程式運行如下：　

　3、初始化主要數據結果如下圖：

　4、運行效果同上一篇文章效果相同

四、其他

　　本篇主要介紹了簡單使用IdentityServer4.EntityFramework持久化存儲相關配置數據和操作數據；本篇中用戶資訊未持久化存儲未介紹，因為IdentityServer4本就支援了接入其他認證方式，如： NetCore 官方的 Identity，可以快速實現用戶管理。

　　Github：//github.com/cwsheng/IdentityServer.Demo　

Tags: IdentityServer4 授權認證