如何使用自定义Attribute实现Web API请求密钥校验与接口安全加固

自定义校验Attribute实现方案 #

你预期的将密钥校验封装为Attribute的方案完全可落地，在ASP.NET Core中可以通过授权过滤器快速实现，示例代码如下：

using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.Filters;

// 自定义请求密钥校验属性
public class ValidTokenAttribute : Attribute, IAsyncAuthorizationFilter
{
    // 实际生产环境请从配置文件、配置中心或密钥管理服务读取，禁止硬编码
    private readonly string _validSecretKey = "12345678910";

    public async Task OnAuthorizationAsync(AuthorizationFilterContext context)
    {
        // 读取请求头中的密钥
        if (!context.HttpContext.Request.Headers.TryGetValue("test", out var requestSecret)
            || string.IsNullOrWhiteSpace(requestSecret)
            || requestSecret != _validSecretKey)
        {
            // 校验不通过直接返回401未授权，不会进入后续业务逻辑
            context.Result = new UnauthorizedResult();
            return;
        }
        await Task.CompletedTask;
    }
}

使用方式和你预期一致，直接在控制器类或单个Action方法上标注[ValidToken]即可，无需每个方法重复编写校验逻辑。如果需要对全局所有接口生效，也可以直接在Program.cs中注册全局过滤器，不用逐个标注。

该方案的安全性评估 #

• 对于内网低敏感场景、内部系统对接场景，该方案可以满足基础的合法调用端校验需求
• 如果是公网部署的API，直接用固定密钥的方案存在明显安全风险：
  • 密钥明文传输，一旦被网络抓包窃取，所有人都可以伪造请求调用接口
  • 密钥没有时效限制，泄露后历史请求可以被无限重放
  • 固定密钥无法动态轮换，一旦泄露需要全量更新所有调用端的配置

全链路安全优化建议 #

针对简单表单提交、校验合法调用端的需求，可以按优先级逐步升级安全防护能力：

1. 传输层基础安全
   • 强制所有接口走HTTPS协议，避免请求头、表单数据明文传输被窃取
   • 密钥统一存放在配置文件或配置中心，开发、测试、生产环境使用不同的密钥，避免代码泄露导致生产密钥外泄
2. 密钥校验逻辑升级
   • 替换固定明文密钥方案为签名校验：调用端将请求参数、当前时间戳、密钥拼接后做SHA256哈希生成签名，请求时只传时间戳和签名，服务端用相同规则计算签名做对比。既不需要明文传递密钥，还可以通过时间戳设置5-15分钟的请求有效窗口，避免重放攻击
   • 后续如果调用端数量增加，可以直接接入成熟的API密钥管理、JWT认证方案，支持密钥动态轮换、调用端权限分级
3. 额外防护补充
   • 接口增加限流规则，避免密钥泄露后被恶意批量调用窃取数据
   • 高敏感接口额外增加IP白名单限制，只允许指定来源IP的请求访问
   • 所有未授权的非法请求统一记录日志，方便后续攻击溯源、异常排查

内容的提问来源于stack exchange，提问作者user8512043