IdentityServer4之持久化很顺手的事

2021 年 2 月 24 日
筆記
IdentityServer4, 微服务那些事

前言

原计划打算在春节期间多分享几篇技术文章的，但到最后一篇也没出，偷懒了吗？算是吧，过程是这样的：每次拿出电脑，在孩姥姥家的院子总有阳光沐浴，看不清屏幕，回屋又有点冷(在强行找理由)，于是又带着娃遛弯去啦。哪有那么多理由，就是想偷个懒；不过后面几天把计算机组成原理简单过了过，后面整理整理再单独给小伙伴分享吧。

这次接着IdentityServer4说，之前一直用内存数据进行测试演示，在正式项目中肯定是要存数据库的(除非数据固定，用内存方式实现)；接下来就用Demo实操的过程说说IdentityServer4的持久化。

正文

IdentityServer4已经对EF Core有很好的支持与封装，用很少的代码就能实现数据持久化，重点还是需要对EF Core有所了解，如果还有不了解的小伙伴，请先花几分钟看看之前分享的关于EF Core的文章(跟我一起学.NetCore之EF Core 实战入门，一看就会)。

主要需要nuget包如下：

IdentityServer4：这个包是IdentityServer4的核心包，项目中只要使用IdentityServer4，就必须引入此包；
IdentityServer4.EntityFramework：这个包是IdentityServer4针对EF进行封装的包，支持使用EF进行数据的持久化；
Microsoft.EntityFrameworkCore.SqlServer：针对不同的数据库引入不同的EF包，这里使用的是微软提供的本地数据库，所以引入的SqlServer；
Microsoft.EntityFrameworkCore.Tools：如果需要在程序的包管理控制台进行迁移操作，就需要在指定程序集中安装此包；
Microsoft.EntityFrameworkCore.Design：如果需要在命令行中进行迁移操作，就需要在指定程序集中安装此包；

注：Demo演示采用的是包管理控制台的方式进行迁移操作；命令行的方式思路是一样的，只是使用的命令稍微有点不同；

Demo走起来

项目准备

这里就不从头到尾敲代码啦，把上一节Authorization Code的代码拷贝过来，重点还是关注持久化的过程(这个理由棒棒哒)。

源码地址：//github.com/zyq025/IDS4Demo/tree/main/AuthorizationCode。
开始撸码

先把包都引入到程序中，如下图：

然后在Startup.cs文件中，将原来的内存模式改为从数据库中读取即可；其实最关键的就是IdentityServer4封装好的两个上下文：
- ConfigurationDbContext：这个上下文主要是针对配置数据，比如客户端(Client)、资源(Resources)等；
- PersistedGrantDbContext：这个上下文主要是针对用户授权操作时的数据和临时数据，比如同意授权的数据、Token等；
在代码中只需要针对这这两个上下文指定数据库就行啦，如果没有什么自定义需求，不用其他配置，如下：
迁移就完事啦

代码撸完啦，剩下的就是EF迁移的几步走就完事啦(这里演示用的包管理控制台)：

注：如果程序中有多个上下文，如果不指定上下文，迁移会报错，因为程序不知要到迁移哪个。
- 新增迁移
  
  指定ConfigurationDbContext：
  
  指定PersistedGrantDbContext：
  
  参数简要说明：
  
  -Context ：指定上下文进行迁移；
  
  -OutputDir：迁移生成的文件存放路径；
  
  最后迁移的文件结果如下：
- 根据迁移文件，同步到数据库中
  
  先同步ConfigurationDbContext
  
  这时候对应的数据库就生成了，而且对应配置相关的表已经在数据库创建：
  
  再同步PersistedGrantDbContext
  
  这个表少，就两张：
其实这样就已经可以啦，只要在数据库对应的表中添加对应的数据，就能进行操作啦；那新手小伙伴肯定得苦恼啦，这么多表，咋知道哪个表存啥数据啊；不急，咱们把原来内存中的数据存进去，然后再看看每个表存了啥，这不就更加明了啦，比一个一个表说的还直接，这种方式还能促使小伙伴动手，不然都不知道里面存了啥(哈哈哈，高招)。那就多出来第四步，如下……
加个种子数据美美哒

这里说的种子数据就是指原来在内存中数据，把它们读出来存到数据库中就行；很简单，通过上文对应直接存即可，代码如下：

方法写好啦，直接在Configure中调用即可，如下：

这样就完工啦，把授权服务器、资源服务器、客户端都启动，走一遍流程，看看是不是成功啦，不出意外一切顺利，这时再返过来看看每个表中都存啥数据，就真的很清晰啦。这里就不一一截图说，相信小伙伴都能搞得明白。

到这肯定有小伙伴要说话啦，用户那还是用的内存；之所以没放到上面一起说，那是因为用户这块的控制权完全在我们自己手里，可以自己设计(就是用户、菜单、角色那一套)，也可以集成微软封装好的Identity(把常用的用户那一套已经封装啦)。

这里演示肯定挑着爽的玩，就集成微软封装好的Identity，来，继续撸码：

引入相关nuget包：

引入的包简单说明

IdentityServer4.AspNetIdentity：IdentityServer4对微软封装的Indentity的支持；

Microsoft.AspNetCore.Identity.EntityFrameworkCore：对Identity提供EF支持；
撸码就对啦：

因为IdentityDbContext是抽象类，不能直接使用，这里需要针对IdentityDbContext定义一个子类ApplicationDbContext，如下：

然后在Startup.cs中注册相关服务即可：
迁移及同步：这里没有指定输出路径，小伙伴根据自己的需要进行指定。

数据库中生成相关的表，如下：
更改登录和登出逻辑；

登出的时调用 _signInManager.SignOutAsync();即可
加点种子数据，即程序启动时加入用户数据；

方法写好，同样在Configure中调用即可，种子数据准备好之后，就可以用Zoe用户进行登录啦，密码就是Zoe123456&