在 Asp.Net Core WebAPI 中防御跨站请求伪造攻击

什么是跨站请求伪造

跨站请求伪造（英语：Cross-site request forgery），也被称为 one-click attack 或者 session riding，通常缩写为 CSRF 或者 XSRF，是一种挟制用户在当前已登录的Web应用程序上执行非本意的操作的攻击方法。【1】跟跨网站脚本（XSS）相比，XSS 利用的是用户对指定网站的信任，CSRF 利用的是网站对用户网页浏览器的信任。

想了解更多，请查看维基百科上的详细介绍。

使用 Asp.Net Core 内置的 Antiforgery

Asp.Net Core 应用中内置了 Microsoft.AspNetCore.Antiforgery 包来支持跨站请求伪造。如果你的应用引用了 Microsoft.AspNetCore.App 包，则就已经包含了 Microsoft.AspNetCore.Antiforgery 。如果没有，则可以使用下面的命令来添加这个包：

dotnet add package Microsoft.AspNetCore.Antiforgery

添加了这个包之后，需要先修改 Startup.cs 文件中的 ConfigureServices 方法，添加下面的配置：

public class Startup {  public void ConfigureServices(IServiceCollection services) {    services.AddAntiforgery(options => {      options.Cookie.SameSite = SameSiteMode.Lax;            options.HeaderName = "X-XSRF-TOKEN";    });  }}

在 SecurityController.cs 文件中添加一个 Api ，来颁发凭据：

[Route("api/[controller]")][ApiController]public class SecurityController : Controller {  private IAntiforgery antiforgery;  public SecurityController(    IAntiforgery antiforgery  ) {    this.antiforgery = antiforgery;  }  [HttpGet("xsrf-token")]  public ActionResult GetXsrfToken() {    var tokens = antiforgery.GetAndStoreTokens(HttpContext);            Response.Cookies.Append(      "XSRF-TOKEN",      tokens.RequestToken,      new CookieOptions {        HttpOnly = false,        Path = "/",        IsEssential = true,        SameSite = SameSiteMode.Lax      }    );    return Ok();  }}

当客户端请求 ~/api/security/xsrf-token 时，服务端发送两个 Cookie ：

.AspNetCore.Antiforgery.xxxxxx 一个 HTTP Only 的 Cookie ，用于服务端验证；
XSRF-TOKEN 客户端需要将这个 Cookie 的值用 X-XSRF-TOKEN 的 Header 发送回服务端，进行验证；

注意：这两个 Cookie 不支持跨域请求，只能在相同的站点内请求，也是出于安全性方面的考虑。

可以为某一个 ApiController 或者 Action 方法单独添加 ValidateAntiForgeryTokenAttribute标记来验证 XSRF-TOKEN，也可以全局注册一个 AutoValidateAntiforgeryTokenAttribute 过滤器来进行自动验证，代码如下：

public class Startup {  public void ConfigureServices(    IServiceCollection services,    IHostingEnvironment env  ) {    services.AddMvc(options => {            if (env.IsProduction()) {        options.Filters.Add(          new AutoValidateAntiforgeryTokenAttribute()        );      }    });  }}