先画一幅流程图理理思路:
1. 问题是这样的:今天在处理一个这样的需求, 在 app\controllers\LoginController.php
中定义了index
方法来处理登录(主要是用于非Web页面登录,比如Curl -X POST http://api/login
):
结果呢, 无论是用测试工具POSTMAN还是用命令行CURL请求总是会得到 http400:Bad Request
的错误;而如果用Web网页方式GET访问(去除verbFilter的POST限制),是正常的
通过帖子下面的帖子找到了问题的所在,是CSRF验证的原因;因为Web网页访问的时候form表单中会有对应的一个隐藏input:_csrf
进行了验证才可以正常进行访问;而非网页访问方式(不通过Web表单)是无法通过csrf验证
的。
而CURL访问方式都没有用到cookie, 故我认为没有必要在这里防范
csrf
攻击,暂时用下面的办法将其禁用。
http://stackoverflow.com/questions/23237377/yii2-curl-bad-request-400
class Controller extends \yii\base\Controller{ /** * @var boolean whether to enable CSRF validation for the actions in this controller. * CSRF validation is enabled only when both this PRoperty and [[Request::enableCsrfValidation]] are true. */ public $enableCsrfValidation = false; <- set this to false
2. 趁机来研究下 Yii2 的 CSRF 防范机制什么是 CSRF 攻击?
简单说, 攻击者盗用了你的身份,以你的名义发送恶意请求。
http://www.cnblogs.com/hyddd/archive/2009/04/09/1432744.htmlhttp://baike.baidu.com/view/1609487.htm?fr=aladdin
最有效地一个方法原理是这样的:
_csrf
,并同时在客户端的COOKIE中保存一个相关联的token
;_POST()
过来的一个input hidden _csrf
跟客户端的COOKIE中的token
进行对照验证利用
(这里抛开XSS
攻击的可能性,由于用户的Cookie很容易由于网站的XSS漏洞而被盗取,这就另外的1%。一般的攻击者看到有需要算Hash值,基本都会放弃了);所以攻击者没法在攻击URL中加入token
,这样就无法通过验证。这可能是最简单的解决方案了,因为攻击者不能获得第三方的Cookie(理论上),所以表单中的数据也就构造失败了:>
3. 从外到内探究来看看:Yii2是不是这么干的。
原创文章,http://www.cnblogs.com/ganiks/Yii文档中有这么一段话是对其CSRF防范机制的概述:
* When CSRF validation is enabled, forms submitted to an Yii Web application must be originated * from the same application. If not, a 400 HTTP exception will be raised. * * Note, this feature requires that the user client accepts cookie. Also, to use this feature, * forms submitted via POST method must contain a hidden input whose name is specified by [[csrfParam]]. * You may use [[\yii\helpers\Html::beginForm()]] to generate his hidden input. * * In javaScript, you may get the values of [[csrfParam]] and [[csrfToken]] via `yii.getCsrfParam()` and * `yii.getCsrfToken()`, respectively. The [[\yii\web\YiiAsset]] asset must be registered. * You also need to include CSRF meta tags in your pages by using [[\yii\helpers\Html::csrfMetaTags()]]
3.1 先看看浏览器中的CSRF都有哪些体现:在第一张图片中,很明显,
<meta>
和<form>
中分别有一个 csrf_token,并且是一致的在第二章图片中,cookies['_csrf']中也有一个更长的串串,这个是。。。?
经过一番研究,这个长长的串是因为Yii默认开启了 cookieValidation
enableCookieValidation
让分析CSRF的过程变得简单在 config文件中禁用:
'components' => [ 'request' => [ // !!! insert a secret key in the following (if it is empty) - this is required by cookie validation'cookieValidationKey' => '83r5HbITBiMfmiYPOZFdL-raVp4O1VV4','enableCookieValidation' => false,'enableCsrfValidation' => true, ]
来对比下禁用之前和之后的区别:3.2 从这样 _csrf 就简单多了,当然这是不安全的
view
开始寻找csrf
3.2.1 先找找表单里的 app\views\site\login.php3.2.2 vendor\yiisoft\yii2\widgets\ActiveForm.php没有找到csrf的定义,那应该是封装到
ActiveForm
了
class ActiveForm extends yii\base\Widget{ public function init() { ... echo yii\helpers\Html::beginForm(...); } public function run() { ... echo yii\helpers\Html::endForm(...); }}
3.2.3 yii\helpers\Html终于找到了CSRF
public static function beginForm($action = '', $method = 'post', $options = []) { $action = Url::to($action); $hiddenInputs = []; $request = Yii::$app->getRequest(); if ($request->enableCsrfValidation && !strcasecmp($method, 'post')) { $hiddenInputs[] = static::hiddenInput($request->csrfParam, $request->getCsrfToken()); } ... ...
3.2.4 去app\views\layouts\main.php
看看里面的CSRF是怎么来的<head> <meta charset="<?= Yii::$app->charset ?>"/> <meta name="viewport" content="width=device-width, initial-scale=1"> <?= Html::csrfMetaTags() ?> <title><?= Html::encode($this->title) ?></title> <?php $this->head() ?></head>
原创文章,http://www.cnblogs.com/ganiks/正好也是在
3.2.3 yii\helpers\Html
中定义的
/** * Generates the meta tags containing CSRF token information. * @return string the generated meta tags * @see Request::enableCsrfValidation */ public static function csrfMetaTags() { $request = Yii::$app->getRequest(); if ($request instanceof Request && $request->enableCsrfValidation) { return static::tag('meta', '', ['name' => 'csrf-param', 'content' => $request->csrfParam]) . "\n " . static::tag('meta', '', ['name' => 'csrf-token', 'content' => $request->getCsrfToken()]) . "\n"; } else { return ''; } }
3.2.5 原来csrf都是由 Yii::$app->request
处理的head中
$request->getCsrfToken()
form中
$request->csrfParam$request->getCsrfToken()
看来 整个验证的流程都是由getCsrfToken()
触发的。
源码请参考:http://www.yiiframework.com/doc-2.0/yii-web-request.html
来个流程图(手绘版):