Laravel CSRF 保护

Posted 2021-04-25 PHP在线中心

CSRF 保护 介绍

Laravel 可以轻松使地保护你的应用程序免受 跨站请求伪造 (CSRF) 攻击。跨站点请求伪造是一种恶意攻击，它凭借已通过身份验证的用户身份来运行未经过授权的命令。

Laravel 会自动为每个活跃的用户的会话生成一个 CSRF「令牌」。该令牌用于验证经过身份验证的用户是否是向应用程序发出请求的用户。

无论何时，当您在应用程序中定义 html 表单时，都应该在表单中包含一个隐藏的 CSRF 标记字段，以便 CSRF 保护中间件可以验证该请求，你可以使用  @csrf  Blade 指令来生成令牌字段，如下：

    
      
      
    

     
       
       
     <form method="POST" action="/profile">
 @csrf
 ...
</form>
    
      
      
    

包含在  web  中间件组里  VerifyCsrfToken  中间件会自动验证请求里的令牌是否与存储在会话中令牌匹配。

CSRF 令牌 & javascript

当构建由 JavaScript 驱动的应用时，可以方便的让 JavaScript HTTP
函数库发起每一个请求时自动附上 CSRF 令牌。默认情况下， resources/js/bootstrap.js  文件中提供的 Axios HTTP 库会使用 cookie 中加密的  XSRF-TOKEN  的值然后在请求时自动发送  X-XSRF-TOKEN  标头。如果不使用此库，则需要为应用程序手动配置此行为。

CSRF 白名单

有时候你可能希望设置一组不需要的 CSRF 保护的 URL 。例如，如果你正在使用 Stripe 处理付款并使用了他们的 webhook 系统，你会需要从 CSRF 的保护中排除 Stripe webhook 处理程序路由，因为 Stripe 并不会给你的路由发送 CSRF 令牌。

典型做法，你可以把这类路由放在  routes/web.php  外，因为  RouteServiceProvider  的  web  中间件适用于该文件中的所有路由。不过，你也可以通过将这类 URL 添加到  VerifyCsrfToken  中间件的  $except  属性来排除对这类路由的 CSRF 保护，如下所示：

    
      
      
    

     
       
       
     <?php

namespace App\Http\Middleware;

use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware;

class VerifyCsrfToken extends Middleware
{
    /**
     * 从CSRF验证中排除的URI
     *
     * @var array
     */
    protected $except = [
        'stripe/*',
        'http://example.com/foo/bar',
        'http://example.com/foo/*',
    ];
}
    
      
      
    

Tip：当 运行测试 时， CSRF 中间件会自动禁用。

X-CSRF-TOKEN

除了检查 POST 参数中的 CSRF 令牌外，  VerifyCsrfToken  中间件还会检查  X-CSRF-TOKEN  请求头。你应该将令牌保存在 HTML meta  标签中，如下：

    
      
      
    

     
       
       
     <meta name="csrf-token" content="{{ csrf_token() }}">
    
      
      
    

然后，一旦你创建了  meta  标签，就可以指示像 jQuery 这样的库自动将令牌添加到所有请求的头信息中。还可以为基于 AJAX 的应用提供简单，方便的 CSRF 保护。如下：

    
      
      
    

     
       
       
     $.ajaxSetup({
 headers: {
 'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content')
 }
});
    
      
      
    

X-XSRF-TOKEN

Laravel 将当前的 CSRF 令牌存储在一个  XSRF-TOKEN  cookie
中，该 cookie 包含在框架生成的每个响应中。你可以使用 cookie 值来设置  X-XSRF-TOKEN  请求头。

这个 cookie 主要是作为一种方便的方式发送的，因为一些 JavaScript 框架和库，例如 Angular 和 Axios ，会自动将它的值放入  X-XSRF-TOKEN  头中。

Tip：默认情况下， resources/js/bootstrap.js  文件包含的 Axios HTTP 库，会自动为你发送。