Yii2框架的csrf驗證原理分析及token快取解決方案

1.CSRF描述

CSRF全稱為「Cross-Site Request Forgery」，是在使用者合法的SESSION內發起的攻擊。駭客通過在網頁中嵌入Web惡意請求程式碼，並誘使受害者存取該頁面，當頁面被存取後，請求在受害者不知情的情況下以受害者的合法身份發起，並執行駭客所期待的動作。以下HTML程式碼提供了一個「刪除產品」的功能：

<a href="http://www.shop.com/delProducts.php?id=100" "javascript:return confirm('Are you sure?')">Delete</a>

假設程式設計師在後台沒有對該「刪除產品」請求做相應的合法性驗證，只要使用者存取了該連結，相應的產品即被刪除，那麼駭客可通過欺騙受害者存取帶有以下惡意程式碼的網頁，即可在受害者不知情的情況下刪除相應的產品。

2.yii的csrf驗證原理 /vendor/yiisoft/yii2/web/Request.php簡寫為Request.php

/vendor/yiisoft/yii2/web/Controller.php簡寫為Controller.php

開啟csrf驗證

在控制器裡將enableCsrfValidation為true，則控制器內所有操作都會開啟驗證，通常做法是將enableCsrfValidation為false,而將一些敏感操作設為true，開啟區域性驗證。

public $enableCsrfValidation = false;
/**
 * @param yiibaseAction $action
 * @return bool
 * @desc: 區域性開啟csrf驗證(重要的表單提交必須加入驗證，加入$accessActions即可
 */
public function beforeAction($action){
    $currentAction = $action->id;
    $accessActions = ['vote','like','delete','download'];
    if(in_array($currentAction,$accessActions)) {
        $action->controller->enableCsrfValidation = true;
    }
    parent::beforeAction($action);
    return true;
}

生成token欄位

在Request.php

首先通過安全元件Security獲取一個32位元的隨機字串，並存入cookie或session，這是原生的token.

/**
 * Generates  an unmasked random token used to perform CSRF validation.
 * @return string the random token for CSRF validation.
 */
protected function generateCsrfToken()
{
    $token = Yii::$app->getSecurity()->generateRandomString();
    if ($this->enableCsrfCookie) {
        $cookie = $this->createCsrfCookie($token);
        Yii::$app->getResponse()->getCookies()->add($cookie);
    } else {
        Yii::$app->getSession()->set($this->csrfParam, $token);
    }
    return $token;
}

接著通過一系列加密替換操作，生成加密後_csrfToken，這個是傳給瀏覽器的token. 先隨機產生CSRF_MASK_LENGTH(Yii2裡預設是8位元)長度的字串 mask

對mask和token進行如下運算 str_replace('+', '.', base64_encode($mask . $this->xorTokens($token, $mask))); $this->xorTokens($arg1,$arg2) 是一個先補位互斥或運算

/**
 * Returns the XOR result of two strings.
 * If the two strings are of different lengths, the shorter one will be padded to the length of the longer one.
 * @param string $token1
 * @param string $token2
 * @return string the XOR result
 */
private function xorTokens($token1, $token2)
{
    $n1 = StringHelper::byteLength($token1);
    $n2 = StringHelper::byteLength($token2);
    if ($n1 > $n2) {
        $token2 = str_pad($token2, $n1, $token2);
    } elseif ($n1 < $n2) {
        $token1 = str_pad($token1, $n2, $n1 === 0 ? ' ' : $token1);
    }
    return $token1 ^ $token2;
}
public function getCsrfToken($regenerate = false)
{
    if ($this->_csrfToken === null || $regenerate) {
        if ($regenerate || ($token = $this->loadCsrfToken()) === null) {
            $token = $this->generateCsrfToken();
        }
        // the mask doesn't need to be very random
        $chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_-.';
        $mask = substr(str_shuffle(str_repeat($chars, 5)), 0, static::CSRF_MASK_LENGTH);
        // The + sign may be decoded as blank space later, which will fail the validation
        $this->_csrfToken = str_replace('+', '.', base64_encode($mask . $this->xorTokens($token, $mask)));
    }

    return $this->_csrfToken;
}

驗證token

在controller.php裡呼叫request.php裡的validateCsrfToken方法

/**
 * @inheritdoc
 */
public function beforeAction($action)
{
    if (parent::beforeAction($action)) {
        if ($this->enableCsrfValidation && Yii::$app->getErrorHandler()->exception === null && !Yii::$app->getRequest()->validateCsrfToken()) {
            throw new BadRequestHttpException(Yii::t('yii', 'Unable to verify your data submission.'));
        }
        return true;
    }
    
    return false;
}
public function validateCsrfToken($token = null)
{
    $method = $this->getMethod();
    if (!$this->enableCsrfValidation || in_array($method, ['GET', 'HEAD', 'OPTIONS'], true)) {
        return true;
    }

    $trueToken = $this->loadCsrfToken();//如果開啟了enableCsrfCookie,CsrfToken就從cookie裡取,否者從session裡取(更安全)

    if ($token !== null) {
        return $this->validateCsrfTokenInternal($token, $trueToken);
    } else {
        return $this->validateCsrfTokenInternal($this->getBodyParam($this->csrfParam), $trueToken)
            || $this->validateCsrfTokenInternal($this->getCsrfTokenFromHeader(), $trueToken);
    }
}

獲取用戶端傳入

$this->getBodyParam($this->csrfParam)

然後是validateCsrfTokenInternal

private function validateCsrfTokenInternal($token, $trueToken)
{
    if (!is_string($token)) {
        return false;
    }
    $token = base64_decode(str_replace('.', '+', $token));
    $n = StringHelper::byteLength($token);
    if ($n <= static::CSRF_MASK_LENGTH) {
        return false;
    }
    $mask = StringHelper::byteSubstr($token, 0, static::CSRF_MASK_LENGTH);
    $token = StringHelper::byteSubstr($token, static::CSRF_MASK_LENGTH, $n - static::CSRF_MASK_LENGTH);
    $token = $this->xorTokens($mask, $token);

    return $token === $trueToken;
}

加密時用的是 str_replace('+', '.', base64_encode(mask.mask.this->xorTokens(token,token,mask))); 解密 1.首先要把.替換成+ 2.然後base64_decode 再 根據長度分別取出mask和mask和this->xorTokens(token,token,mask) ; 為了說明方便 this?>xorTokens(this?>xorTokens(token, $mask) 這裡稱作 token1 然後 進行mask和token1的互斥或運算,即得token 注意在加密時

token1=token^mask

所以 解密時

token=mask^token1=mask^(token^mask)

3.token快取的解決方案

當頁面整體被快取後，token也被快取導致驗證失敗，一種常見的解決思路是每次提交前重新獲取token,這樣就可以通過驗證了。

附錄：

str_pad()，該函數返回 input 被從左端、右端或者同時兩端被填充到制定長度後的結果。如果可選的 pad_string 引數沒有被指定，input 將被空格字元填充，否則它將被 pad_string 填充到指定長度；

str_shuffle() 函數打亂一個字串，使用任何一種可能的排序方案。

因為yii2 csrf的驗證的加解密 涉及到互斥或運算

所以需要先補充php裡字串互斥或運算的相關知識,不需要的可以跳過

^互斥或運算 不一樣返回1 否者返回 0 在PHP語言中,經常用來做加密的運算,解密也直接用^就行 字串運算時 利用字元的ascii碼轉換為2進位制來運算 單個字元運算

1.對於單個字元和單個字元的 直接計算其結果即可 比如表裡的a^b

2.對於長度一樣的多個字串 如表裡的ab^cd 計算a^c對應的結果和和b^d對應的結果 對應的字元連線起來

相關教學：PHP視訊教學

以上就是Yii2框架的csrf驗證原理分析及token快取解決方案的詳細內容，更多請關注TW511.COM其它相關文章！