You need to enable JavaScript to run this app. ASP.NET Core 3.1中如何基于HTTP请求头实现简易授权?
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.15 01:45:06