Identity Server 4 - Hybrid Flow - Claims
前一篇 Identity Server 4 - Hybrid Flow - MVC客户端身份验证: https://www.cnblogs.com/cgzl/p/9253667.html
Claims
我不知道怎么样翻译这个词比较好, 所以我一般就不翻译了.
在前一篇文章里, MVC客户端配置身份认证的时候有这么一句话(Startup的ConfigureServices):
官方文档是这样介绍的: “我们关闭了JWT的Claim 类型映射, 以便允许well-known claims.”
如果我把这句话删掉, 然后再看看User.Claims的类型和值:
现在有些claim的类型与ID Token里面的类型名称是不一样, 也有一些claim不见了:
而加上这句话之后, 现在User claim类型的名字就和ID Token里面一样了:
再看一下ID Token:
有一些claims并没有出现在User.Claims里面. 这是因为这个中间件默认情况下会过滤掉一些它认为我们不需要的claim, 例如nbf, amr等.
就先看下面这两种情况吧:
1. 避免claims被默认过滤掉
如果我想让中间件不要过滤掉nbf和, 也就是把nbf和amr从被过滤掉集合里移除, 就可以使用这个方法:
然后再看About页面打印的UserClaims:
这样nbf和amr就不会被过滤掉了(从过滤掉的集合移除了).
2. 删除某些Claims
假如说我这个MVC客户端不需要sid和idp, 那么我可以使用下面的方法:
这是一个扩展方法, 一定要注意它和Remove方法的区别.........
再次操作后, 可以看到这些Claims不见了:
ClaimActions还有其他几个方法, 请自行探索.
用户信息端点 UserInfo Endpoint
尽管ID Token里面可以包含很多用户的claims, 但是尽量让ID Token小一点比较好. 所以当MVC客户端需要更多用户信息的时候可以手动请求用户信息端点, 这样做也可以获得用户最新的其他信息.
UserInfo Endpoint的官方文档在这: http://openid.net/specs/openid-connect-core-1_0.html#UserInfo
它要求使用GET或者POST进行请求, 但建议使用GET. 此外请求还需要使用Access Token.
这是一个例子:
成功请求的响应结果是一个JSON对象.
首先在IDP里面再添加一个email scope:
然后在配置的Client里面添加这个scope:
最后为TestUser添加email的claim:
回到MVC客户端的Startup, 这里也需要添加email这个scope,
而且还要保证这个email不会出现在claims Identity里面, 这样我在请求用户信息端点的时候才会得到email而不是从User.Claims里面得到:
再次操作后, 可以看到User.Claims里没有出现email:
下面我需要手动发送请求到用户信息端点来获取其他信息:
identity sever 4的这部分文档在: https://identityserver4.readthedocs.io/en/release/endpoints/userinfo.html#identitymodel, https://github.com/IdentityModel/IdentityModel2
文档提到, 需要为MVC客户端安装IdentityModel这个库:
dotnet add package IdentityModel
随后, 我把获取用户email的代码还是放在About Action里:
首先通过IDP的URI获得discovery document, 然后从中取出UserInfo端点, 从Cookie里得到access token, 并用access token从用户信息端点获得claims, 从这些claims里面取得email并传递到About.cshtml.
相应的修改一下About.html:
重新操作后看About页面:
对MVC客户端使用基于角色对授权
首先需要在IDP那里对两个用户添加role这个claim:
分别是管理员角色和注册用户角色.
OpenID Connect并没有定义关于角色role相关的scope, 所以我还需要自定义一个scope:
第一个参数是scope的名字, 第二个参数是scope的显示名, 第三个参数是它所包含的claim类型, 这里就是“role”.
然后还需要客户端允许请求“roles”这个scope:
IDP这边配置完了, 下面是MVC客户端的配置, 打开MVC的startup, 添加“roles”这个scope:
下面测试, 可以看到在同意页面确实请求了角色“roles”这个scope:
然后同意后却无法从User.Claims里看到角色role 这个claim:
这是因为ASP.NET默认对UserInfo返回的JSON数据里一些常用的顶层claim进行了映射, 以便它们能够出现在User.Claims里面.
我也只需要把JSON里面的role claim, 映射到User.Claims里即可:
再次操作后, 就可以在User.Claims看到角色了:
然后我便可以在MVC客户端的任意地方通过角色来控制用户的访问权限了, 例如:
但是如何把role claim映射成ASP.NET Core MVC可以识别的角色Roles呢?
可以在MVC里这样配置:
该参数主要是配置验证Token的一些东西, 然而它还可以指定客户端的Name 和 Role Claim的类型.
操作后用两个用户分别测试一下, Nick 管理员, 可以访问About:
另一个用户, Dave 注册用户, 则不可以访问About:
这说明角色已经被MVC客户端识别了.
但是对于Dave这个用户来说, 没有权限访问About时, 页面显示非常不友好, 所以下面解决这个问题.
首先建立一个AuthroizationController:
然后建立相关的view:
最后在Startup里面配置, 如果没有权限就跳转到这个Action上:
再次操作后, Dave点击About后就会因为权限不足而跳转到该页面:
今天先到这, 我自己几乎不用MVC, 我主要是做Web API的, 这部分的内容大部分来自官方文档和其他一些资料综合出来的.
代码: https://github.com/solenovex/Identity-Server-4-Tutorial-Code 02部分
