如何实现前置运行的自定义认证过滤器,成功时绕过[Authorize]授权校验
问题根因
此前实现的低Order自定义授权过滤器在.NET Core 3.1+失效的核心原因是:
- 从.NET Core 3.1开始,框架的授权管道执行时机做了调整,与
[Authorize]特性绑定的内置授权过滤器,是内嵌在端点路由解析流程中执行的,执行优先级远高于MVC管道中注册的普通IAuthorizationFilter - 哪怕给自定义过滤器设置
Order=0,也无法让它抢在内置授权校验之前执行——内置授权在路由匹配完成、进入MVC动作调用管道前就已经完成了校验,根本没有给自定义过滤器留前置判断的时机,Order参数对这个阶段的过滤器执行顺序不生效
可行实现方案
方案1:自定义组合式授权策略(最贴合框架设计,无管道侵入)
这个方案完全适配内置授权管道,无需调整原有授权流程的结构,适合给部分Action/控制器单独配置旁路校验逻辑:
- 首先在服务注册阶段定义带旁路逻辑的授权策略,替代原有直接标注的
[Authorize]特性 - 策略内部实现自定义校验逻辑:优先检查请求携带的自定义查询字符串参数是否合法,合法则直接授权通过;不合法则自动走原有授权校验流程
示例代码片段:
// Startup/Program.cs 中的授权服务配置 builder.Services.AddAuthorization(options => { options.AddPolicy("BypassAuthPolicy", policy => { // 绑定原有授权使用的认证方案,和普通[Authorize]的行为保持一致 policy.AddAuthenticationSchemes("你原有的认证方案名"); // 注入自定义的旁路校验规则 policy.Requirements.Add(new QueryStringBypassRequirement( paramName: "自定义查询参数名", validSignRule: 你的查询参数合法性校验规则 )); }); });
对应的校验处理器逻辑:
- 从
HttpContext.Request.Query中读取目标查询参数,按照约定规则做合法性校验(签名比对、有效期校验、白名单匹配等) - 校验通过时直接调用
context.Succeed(),跳过后续的身份校验环节,直接放行进入Action执行 - 校验不通过时不做特殊处理,框架自动触发绑定的认证方案执行原有授权流程,和普通
[Authorize]的行为完全一致
方案2:路由前置中间件旁路校验(无需修改原有Action的Authorize标注)
如果不想调整原有Action上的[Authorize]标注,可以通过管道位置调整实现校验前置:
- 把自定义校验逻辑做成中间件,放置在
UseRouting()之后、UseAuthorization()之前的管道节点上 - 中间件执行时先判断当前匹配的端点是否需要做查询字符串旁路校验
- 校验通过时,直接给
HttpContext.User赋值合法的身份主体,后续内置授权管道检测到合法的用户身份时会直接通过 - 校验不通过时不做任何处理,后续授权管道完全按照原有
[Authorize]的规则执行
注意避坑
- 不要试图通过低Order的
IAuthorizationFilter抢夺执行时机,这种实现方式在.NET Core 3.1+的管道结构下天然不生效- 不要在校验通过后直接短路返回Action结果,这样会绕过MVC的模型绑定、全局动作过滤器等正常流程,引发逻辑异常
内容的提问来源于stack exchange,提问作者idchlife
相关产品推荐
相关产品推荐

