ASP.NET Core 8.0 重大变更：IFormFile参数现在需要防伪检查

ASP.NET Core 8.0 重大变更：IFormFile参数现在需要防伪检查

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs

引言

在ASP.NET Core 8.0中，微软引入了一项重要的安全变更：当Minimal API端点使用IFormFile或IFormFileCollection参数时，现在默认要求进行防伪令牌验证。这一变更旨在提升Web应用的安全性，防止跨站请求伪造(CSRF)攻击。

变更背景

什么是防伪验证？

防伪验证(Anti-forgery validation)是一种安全机制，用于确保表单提交请求确实来自你的应用程序，而不是恶意网站。它通过生成和验证唯一的令牌来实现这一点。

为什么需要这个变更？

在之前的版本中，Minimal API处理文件上传时并不强制要求防伪验证，这可能存在安全隐患。考虑到文件上传是Web应用中常见的功能，且可能涉及重要操作，强制防伪验证成为了必要的安全措施。

变更详情

版本引入

此变更首次出现在ASP.NET Core 8.0 RC1版本中。

旧行为

在ASP.NET Core 8.0之前，Minimal API端点通过IFormFile或IFormFileCollection绑定表单参数时，不需要进行防伪验证。

新行为

从ASP.NET Core 8.0 RC1开始：

1. 使用IFormFile或IFormFileCollection参数的Minimal API端点默认需要防伪验证
2. 如果未为这些API注册防伪中间件，应用启动时将抛出异常

影响范围

这是一个行为变更(behavioral change)，会影响所有使用IFormFile或IFormFileCollection参数的Minimal API端点。

应对措施

基本解决方案

确保在应用程序中注册防伪中间件：

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// 添加防伪中间件
app.UseAntiforgery();

// 其他中间件和端点配置
app.Run();

特殊情况处理

如果确实需要为某些端点禁用防伪验证，可以使用DisableAntiforgery方法：

app.MapPost("/upload", (IFormFile file) => 
{
    // 处理文件上传
}).DisableAntiforgery();

最佳实践建议

1. 尽量保持防伪验证启用：除非有充分理由，否则不要禁用防伪验证
2. 前端配合：确保前端表单包含防伪令牌字段
3. 测试验证：在升级后全面测试文件上传功能
4. 文档更新：更新API文档，告知客户端需要发送防伪令牌

技术原理深入

防伪验证通过以下方式工作：

1. 服务器生成唯一的防伪令牌
2. 令牌被嵌入到表单中作为隐藏字段
3. 表单提交时，令牌随请求一起发送
4. 服务器验证令牌的有效性

对于文件上传场景，这种验证尤为重要，因为：

• 文件上传可能修改服务器状态
• 上传的文件可能包含重要信息
• 未授权用户可能利用未受保护的上传端点进行不当操作

总结

ASP.NET Core 8.0的这一变更强化了Minimal API的安全性，特别是文件上传场景。开发者需要了解这一变更并相应调整应用程序配置。虽然这增加了一些开发成本，但从安全角度考虑是非常值得的。

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs