学习ASP.NET Core的身份认证(基于JwtBearer的身份认证4)

本文学习并记录builder.Services.AddAuthentication().AddJwtBearer函数中配置类的主要属性及用途。AddJwtBearer函数原型如下图所示,划红线的为常用形式,主要设置JwtBearerOptions类型的常用属性或事件。
  JwtBearerOptions类中的属性虽多,但从参考文献的示例来看,大多没有直接设置,主要是对TokenValidationParameters属性设置,该属性与Token验证息息相关,除此之外,参考文献4中还设置了Events属性,该属性类型为JwtBearerEvents,可以处理Token验证时的各类事件,如下图所示:

  JwtBearerOptions.TokenValidationParameters的类型为TokenValidationParameters,其常用的属性如下表所示:

序号 属性 说明
1 ClockSkew 设置或获取时间验证时的时间漂移,默认为300秒,根据参考文献9中的解释,该属性用于处理生成Token和验证Token的服务器之间的可能的时间不同步问题,也即两个时间的误差在ClockSkew范围内即可认为是验证通过
2 IssuerSigningKey 类型为SecurityKey,保存签证Token签名时所需的密钥
3 NameClaimType string类型,设置有效负载中的name声明的默认类型,也即保存姓名的键值对中的默认键值,一般都使用默认值
4 PropertyBag IDictionary<string, object>,保存有效负载中自定义声明信息的键值对,以支持自定义声明信息的验证
5 RequireExpirationTime bool类型,默认值为true,标志有效负载中是否要存在到期时间声明,也即有类型为exp的键值对
6 RoleClaimType string类型,设置有效负载中的role声明的默认类型,也即保存角色的键值对中的默认键值,一般都使用默认值
7 ValidAudience string类型,设置有效受众(Audience),以便需验证受众时与有效负载中的声明信息进行对比
8 ValidAudiences IEnumerable类型,保存有多个有效受众,验证受众时只要存在aud类型声明信息,且值在集合内即可通过验证
9 ValidIssuer string类型,设置有效发行者(Issuer),以便需验证发行者时与有效负载中的声明信息进行对比
10 ValidIssuers Enumerable类型,保存有多个有效发行者,验证发行者时只要存在iss类型声明信息,且值在集合内即可通过验证
11 ValidateIssuer bool类型,默认值为true,设置验证Token时是否验证有效负载中的发行者声明是否与验证程序中的一致
12 ValidateAudience bool类型,默认值为true,设置验证Token时是否验证有效负载中的受众声明是否与验证程序中的一致
13 ValidateLifetime bool类型,默认值为true,设置验证Token的声明周期,也即是否超过Token中指定的过期时间+ClockSkew

TokenValidationParameters中的其它属性大多是代理函数声明,用于在特定应用场景中替换微软JwtBearer中默认的处理函数。

参考文献:

[1]https://www.jianshu.com/p/a2804e72d296

[2]https://blog.csdn.net/sD7O95O/article/details/85043160

[3]https://www.cnblogs.com/qiongkangle/p/13347283.html

[4]https://www.cnblogs.com/xbhp/p/17401507.html

[5]https://www.cnblogs.com/superstar/p/16491428.html

[6]https://blog.csdn.net/weixin_44877917/article/details/140609294

[7]https://blog.csdn.net/qq_40287041/article/details/143368882

[8]https://learn.microsoft.com/zh-cn/dotnet/api/microsoft.identitymodel.tokens.tokenvalidationparameters?view=msal-web-dotnet-latest

[9]https://blog.csdn.net/kan_kongzhizhen/article/details/138670376

相关推荐
gc_22994 天前
学习ASP.NET Core的身份认证(基于JwtBearer的身份认证2)
身份认证·jwtbearer
gc_22995 天前
学习ASP.NET Core的身份认证(基于JwtBearer的身份认证3)
jwtbear·jwt token
安 当 加 密7 天前
中小学教室多媒体电脑安全登录解决方案
数据安全·访问控制·身份认证·日志审计·多因素认证·操作系统登录双因素认证
安 当 加 密7 天前
【安当产品应用案例100集】032-重塑企业SaaS平台的PostgreSQL凭据管理体系
数据库·数据安全·访问控制·身份认证·加密技术·凭据管理
gc_22991 个月前
学习ASP.NET Core的身份认证(基于Session的身份认证3)
asp.net core·session·身份认证
gc_22991 个月前
学习ASP.NET Core的身份认证(基于Session的身份认证1)
asp.net core·session·身份认证
gc_22991 个月前
学习ASP.NET Core的身份认证(基于Cookie的身份认证1)
asp.net core·cookie·身份认证
gc_22991 个月前
学习ASP.NET Core的身份认证(基于Cookie的身份认证3)
asp.net core·cookie·身份认证
安 当 加 密1 个月前
一分钟学习数据安全——IAM系统的数据访问控制模型
数据安全·权限管理·rbac·访问控制·身份认证·访问控制模型·基于角色的访问控制模型