ASP.NET Core 3.1中如何基于HTTP请求头实现简易授权?
基于请求头实现.NET Core 3.1接口角色授权的简单方案
针对你的场景,以下两种方案都比官方策略授权更轻量,代码量少且容易调试:
方案一:自定义授权过滤器(最简实现,无需修改认证逻辑)
直接实现IAuthorizationFilter自定义特性,打在控制器或接口上即可完成角色校验,适合只想做简单权限判断的场景:
1. 实现自定义授权特性
using Microsoft.AspNetCore.Mvc; using Microsoft.AspNetCore.Mvc.Filters; using System; using System.Linq; public class RoleFromHeaderAttribute : Attribute, IAuthorizationFilter { private readonly string[] _requiredRoles; // 支持传入多个允许访问的角色 public RoleFromHeaderAttribute(params string[] requiredRoles) { _requiredRoles = requiredRoles; } public void OnAuthorization(AuthorizationFilterContext context) { // 读取SP传递的角色请求头 if (!context.HttpContext.Request.Headers.TryGetValue("SP_USER_ROLE", out var roleHeader)) { context.Result = new ForbidResult(); return; } // 适配多角色场景,按实际分隔符拆分即可,示例用逗号 var userRoles = roleHeader.ToString() .Split(',', StringSplitOptions.RemoveEmptyEntries) .Select(r => r.Trim()); // 角色匹配校验 if (!_requiredRoles.Any(r => userRoles.Contains(r, StringComparer.OrdinalIgnoreCase))) { // 自定义权限不足返回内容 context.Result = new JsonResult(new { Code = 403, Message = "当前用户权限不足,无法访问该接口" }) { StatusCode = 403 }; return; } } }
2. 使用方式
直接打在控制器或接口上即可:
[ApiController] [Route("api/[controller]")] public class DataController : ControllerBase { // 仅允许admin角色访问 [RoleFromHeader("admin")] [HttpGet("admin/config")] public IActionResult GetAdminConfig() { return Ok(); } // 允许admin和operator两个角色访问 [RoleFromHeader("admin", "operator")] [HttpGet("list")] public IActionResult GetDataList() { return Ok(); } }
如果需要全局给所有接口加基础权限校验,可以在Startup.cs的ConfigureServices中注册:
services.AddControllers(options => { // 所有接口默认需要user角色才能访问 options.Filters.Add(new RoleFromHeaderAttribute("user")); });
方案二:请求头转Claims中间件(复用原生授权特性)
如果后续需要用到用户身份信息,推荐用这个方案:把SP传递的请求头转成.NET原生的ClaimsPrincipal,直接复用框架自带的[Authorize]特性:
1. 实现身份转换中间件
using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Http; using System.Security.Claims; using System.Threading.Tasks; public class HeaderAuthMiddleware { private readonly RequestDelegate _next; public HeaderAuthMiddleware(RequestDelegate next) { _next = next; } public async Task InvokeAsync(HttpContext context) { // 只有SP传递了用户信息头才构造身份 if (context.Request.Headers.TryGetValue("SP_USER_NAME", out var userName) && context.Request.Headers.TryGetValue("SP_USER_ROLE", out var roleHeader)) { var claims = new List<Claim> { new Claim(ClaimTypes.Name, userName.ToString()) }; // 添加角色声明 foreach (var role in roleHeader.ToString().Split(',', StringSplitOptions.RemoveEmptyEntries)) { claims.Add(new Claim(ClaimTypes.Role, role.Trim())); } context.User = new ClaimsPrincipal(new ClaimsIdentity(claims, "SAMLSPAuth")); } await _next(context); } } // 注册扩展方法 public static class HeaderAuthMiddlewareExtensions { public static IApplicationBuilder UseHeaderAuth(this IApplicationBuilder builder) { return builder.UseMiddleware<HeaderAuthMiddleware>(); } }
2. 注册中间件
在Startup.cs的Configure方法中注册,注意必须放在UseAuthorization之前:
public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { app.UseRouting(); // 新增行:注册请求头身份转换中间件 app.UseHeaderAuth(); app.UseAuthorization(); app.UseEndpoints(endpoints => { endpoints.MapControllers(); }); }
3. 使用方式
直接用.NET原生的授权特性即可:
// 校验用户已登录 [Authorize] [ApiController] [Route("api/[controller]")] public class UserController : ControllerBase { // 校验角色为admin [Authorize(Roles = "admin")] [HttpGet("config")] public IActionResult GetConfig() { return Ok(); } // 允许多个角色访问 [Authorize(Roles = "admin,user")] [HttpGet("info")] public IActionResult GetUserInfo() { // 可以直接通过User对象获取用户信息 var userName = User.Identity.Name; var isAdmin = User.IsInRole("admin"); return Ok(new { userName, isAdmin }); } }
注意事项
- 生产环境必须限制应用仅能被SAML SP的IP访问,避免攻击者伪造请求头绕过身份校验
- 可以根据实际业务调整请求头名称、角色分隔符、权限不足的返回格式
- 如果是多实例部署,不需要额外做分布式配置,所有校验逻辑都在本地请求中完成
内容的提问来源于stack exchange,提问作者sfphoton
相关产品推荐
相关产品推荐

