CSRF与AJAX

最新推荐文章于 2023-11-13 19:34:33 发布

鳳舞酒天

最新推荐文章于 2023-11-13 19:34:33 发布

阅读量149

点赞数

分类专栏： web Python 文章标签： django python Powered by 金山文档

原文链接：https://www.liujiangblog.com/course/django/179

版权

web 同时被 2 个专栏收录

13 篇文章 0 订阅

订阅专栏

Python

6 篇文章 1 订阅

订阅专栏

CSRF（Cross-site request forgery）跨站请求伪造，是一种常见的网络攻击手段，具体内容和含义请大家自行百度。

Django为我们提供了防范CSRF攻击的机制。

一、基本使用

默认情况下，使用django-admin startproject xxx命令创建工程时，CSRF防御机制就已经开启了。如果没有开启，请在MIDDLEWARE设置中添加'django.middleware.csrf.CsrfViewMiddleware'。

对于GET请求，一般来说没有这个问题，CSRF通常是针对POST方法的！

在含有POST表单的模板中，只需要在其<form>表单内部添加csrf_token标签，如下所示：

<formaction=""method="post">{%csrf_token%}....</form>

这样，实际上就是生成了一个隐藏的名称为'csrfmiddlewaretoken'的input输入框，这个input的值就是Django提供给表单的csrf_token。

当表单数据通过POST方法，发送到后台服务器的时候，除了正常的表单数据外，还会携带这个CSRF令牌随机字符串，用于进行csrf验证。

其实没有多么麻烦和复杂，对么？如果表单中没有携带这个csrf令牌，你将会获得一枚403奖章。

额外提示：对于初学者，要明白一件事情，就是我们上面讲的都是Django项目自己内部的事务，不涉及与外界的关系。例如，你不能把上面那个表单发往百度，百度会懵逼的，你这发的啥？其次，那样也不安全，可能引起CSRF信息泄露而导致自己的站点出现漏洞。

二、 AJAX

我们知道，在前端的世界，有一种叫做AJAX的东西，也就是“Asynchronous Javascript And XML”（异步 JavaScript 和 XML），经常被用来在不刷新页面的情况下，提交和请求数据。如果我们的Django服务器接收的是一个通过AJAX发送过来的POST请求的话，那么将很麻烦。

为什么？因为AJAX中，没有办法像form表单中那样通过一个隐藏的input标签携带{% csrf_token %}令牌。

那怎么办呢？其实也很好办。

首先我们要知道CSRF中间件会在cookie中写入CSRF令牌随机字符串。

我们只需要通过JS代码获取这个字符串，然后随同AJAX发送到后台服务器即可。

这个随同的过程也很简单，很多JS框架都提供修改HTTP头部的钩子，我们可以在header中添加X-CSRFToken键值对，值就是CSRF令牌。键的名字可以通过 CSRF_HEADER_NAME配置项自定义，但一般保持默认值就好。

然后第一步是获取cookie中的CSRF令牌，不过这取决于两个配置项：

当CSRF_USE_SESSIONS 和CSRF_COOKIE_HTTPONLY 都是False的时候

CSRF_USE_SESSIONS 为True表示将csrf的令牌储存在会话中。
CSRF_COOKIE_HTTPONLY 为True表示客户端的JS代码不能访问cookie。
一般来说，大多Web服务器都会保持这两个设置为False，因为True没什么实际意义。

此时直接去cookie中读取CSRF令牌即可(将下面的代码抄到你的HTML中)：

functiongetCookie(name){letcookieValue=null;if(document.cookie&&document.cookie!==''){constcookies=document.cookie.split(';');for(leti=0;i<cookies.length;i++){constcookie=cookies[i].trim();// Does this cookie string begin with the name we want?if(cookie.substring(0,name.length+1)===(name+'=')){cookieValue=decodeURIComponent(cookie.substring(name.length+1));break;}}}returncookieValue;}constcsrftoken=getCookie('csrftoken');

如果你安装了js-cookie前端库，那么上面的代码可以简化为：

constcsrftoken=Cookies.get('csrftoken');

'csrftoken'是默认情况下CSRF令牌储存在cookie中的键，可以通过CSRF_COOKIE_NAME设置来自定义名称。

注意，为了保证在没有表单系统的时候，Django向cookie中写入了CSRF令牌，你需要在视图上使用装饰器django.views.decorators.csrf.ensure_csrf_cookie。

当CSRF_USE_SESSIONS 和CSRF_COOKIE_HTTPONLY 有一个是True的时候

这个时候显然，cookie中即使有CSRF令牌也读取不到。

我们需要在Django进行render（request, 'xxx.html',{}）的时候，在HTML文件中显式地添加一个csrf_token到DOM中，然后通过JS代码获得它，如下所示:

{%csrf_token%}<script>constcsrftoken=document.querySelector('[name=csrfmiddlewaretoken]').value;</script>

现在，我们通过JS手段成功获取到了CSRF令牌，然后就是通过AJAX在发送POST数据的同时一起发送它了：

constrequest=newRequest(/* URL */,{headers:{'X-CSRFToken':csrftoken}});fetch(request,{method:'POST',mode:'same-origin'// Do not send CSRF token to another domain.}).then(function(response){// ...});

以上是ES6新语法（不再使用JQuery了），如果不熟悉的可以自行学习或者观看我的Vue视频。

三、装饰器

1. 单独指定csrf验证需要

有时候，我们在全站上关闭了CSRF功能，但是希望某些视图还有CSRF防御，那怎么办呢？

Django为我们提供了一个csrf_protect(view)装饰器，使用起来非常方便，如下所示：

fromdjango.shortcutsimportrenderfromdjango.views.decorators.csrfimportcsrf_protect@csrf_protectdefmy_view(request):c={}# ...returnrender(request,"a_template.html",c)

现在，虽然全站关掉了csrf，但是my_view视图依然需要进行csrf验证。

另外，当你缓存某个视图的时候，由于缓存的机制，你必须显式的为需要csrf保护的视图添加此装饰器：

fromdjango.views.decorators.csrfimportcsrf_protect@cache_page(60*15)@csrf_protectdefmy_view(request):...

2. 单独指定忽略csrf验证

有正就有反。在全站开启CSRF机制的时候，有些视图我们并不想开启这个功能。比如，有另外一台机器通过requests库，模拟HTTP通信，以POST请求向我们的Django主机服务器发送过来了一段保密数据。它无法携带CSRF令牌，必然会被403。

这怎么办呢？

在接收这个POST请求的视图上为CSRF开道口子，不进行验证。这就需要使用Django为我们提供的csrf_exempt(view)装饰器了，下面是使用范例：

fromdjango.views.decorators.csrfimportcsrf_exemptfromdjango.httpimportHttpResponse@csrf_exemptdefmy_view(request):returnHttpResponse('Hello world')

这下POST数据是没问题了，但是又带来了新的安全问题，需要你自己处理。

最常见的用法如下：

fromdjango.views.decorators.csrfimportcsrf_exempt,csrf_protect@csrf_exempt# 外面忽略csrfdefmy_view(request):@csrf_protect# 里面需要csrfdefprotected_path(request):do_something()ifsome_condition():returnprotected_path(request)else:do_something_else()

3. 确保csrf令牌被设置

Django还提供了一个装饰器，确保被装饰的视图在返回HTML页面给前端用户时同时将csrf令牌写入Cookie。

这个装饰器是：ensure_csrf_cookie(view)，其使用方法和上面的一样：

fromdjango.views.decorators.csrfimportensure_csrf_cookiefromdjango.httpimportHttpResponse@ensure_csrf_cookiedefmy_view(request):returnHttpResponse('Hello world')

4. requires_csrf_token(view)

这个装饰器类似csrf_protect，一样要进行csrf验证，但是它不会拒绝发送过来的请求。

fromdjango.views.decorators.csrfimportrequires_csrf_tokenfromdjango.shortcutsimportrender@requires_csrf_tokendefmy_view(request):c={}# ...returnrender(request,"a_template.html",c)