IdentityServer4 4.x已经正式发布了,根据官方的 Release Note,3.1.x 到 4.x 的变更也是非常多,今天在将代码迁移到 4.x 遇到了一些问题在此记录下来,我使用的 IdentityServer4 的各种数据持久化,比如 ClientStore,ResourceStore 等,都是完全自定义的,非 EntityFramework,如果你是使用的 EF 那么官方提供了迁移脚本,请自行查找。
二. Resource 相关变化ApiResource 的 Scope 正式独立出来为 ApiScope 对象,开发者可能是想让用户明白 ApiResource 和 Scope 的关系,而不是把它们混为一谈,因为以前这一步都是 IdentityServer4 帮你做了,会自动以 ApiResource 的名称为 Scope,所以可能存在认为它们两个是相等的情况,实际则不然,Scope 是属于 ApiResource 的一个属性,可以包含多个 Scope。以源码来看:
1.ApiResource 的变化3.1.x:
4.x:
2.InMemory 运行方式的变化对于大家在学习 IdentityServer4 时熟悉的 InMemory 来说,AddInMemoryApiResources 变为了 AddInMemoryApiScopes 也就是变了名字,但一定要明白这里面实际的不同。
3.1.x:
4.x:
3.Resources 的变化此类的构造方法变了,增加了 apiScopes 的参数,直接受影响的是 IResourceStore 的实现,如果自定义了此接口的实现,那么需要注意这个问题。
3.1.x:
4.x:
4.IResourceStore 的变化 三.PublicOrigin 属性被删除IdentityServerOptions 对象中 PublicOrigin 属性没有了,此属性涉及到在生产环境经过nginx反向代理等设施后 configuration endpoint 获取到的地址的准确性,经过查询官方的 Issues,目前有两个解决方案:
1.在中间件中调用扩展方法
app.Use(async (ctx, next) => { ctx.SetIdentityServerOrigin("https://foo.com"); await next(); });or
app.Use(async (ctx, next) => { ctx.Request.Scheme = "https"; ctx.Request.Host = new HostString("foo.com"); await next(); });2.正确设置反向代理中的 X-Forwarded-For、X-Forwarded-Proto和X-Forwarded-Host,详细设置请查看:Configure ASP.NET Core to work with proxy servers and load balancers
相关资料:
Where is PublicOrigin option now? #4535
关于此问题官方人员的原话:It's gone. It was a hack - please use the forwarded headers approach in ASP.NET Core from now on. 我个人更推荐第二个方法
四.IPersistedGrantStore 的变化IPersistedGrantStore 接口的方法参数有变动:
五.总结以上就是我在 IdentityServer4 3.1.x 到 4.x 迁移所遇到的各个问题,所有问题都解决了并且成功运行。我是重度自定义接口实现,包括表都是自行设计的,非EF,自定义实现的接口如下:IClientStore、IPersistedGrantStore、IProfileService、IResourceOwnerPasswordValidator、IResourceStore。3.1.x 到 4.x 确实许多 break changes,但从遇到的几个实际问题来说,开发人员在设计是已尽量兼容了老版本,希望我所遇到的问题,能帮到大家。官方开了一个 issues 记录迁移的问题,如果大家有难以解决的问题,不妨去提交:https://github.com/IdentityServer/IdentityServer4/issues/4592