在Express中如何使用cookie-parser中間件

文章導(dǎo)讀

cookie-parser 是Express的中間件，用來(lái)實(shí)現(xiàn)cookie的解析，是官方腳手架內(nèi)置的中間件之一。

它的使用非常簡(jiǎn)單，但在使用過(guò)程中偶爾也會(huì)遇到問(wèn)題。一般都是因?yàn)閷?duì) Express + cookie-parser 的簽名、驗(yàn)證機(jī)制不了解導(dǎo)致的。

本文深入講解 Express + cookie-parser 的簽名和驗(yàn)證的實(shí)現(xiàn)機(jī)制，以及cookie簽名是如何增強(qiáng)網(wǎng)站的安全性的。

文本同步收錄于GitHub主題系列 《Nodejs學(xué)習(xí)筆記》

入門例子：cookie設(shè)置與解析

先從最簡(jiǎn)單的例子來(lái)看下 cookie-parser 的使用，這里采用默認(rèn)配置。

1. cookie設(shè)置：使用 Express 的內(nèi)置方法 res.cookie() 。

2. cookie解析：使用 cookie-parser 中間件。

var express = require('express');
var cookieParser = require('cookie-parser');
var app = express();
app.use(cookieParser());
app.use(function (req, res, next) {
 console.log(req.cookies.nick); // 第二次訪問(wèn)，

在當(dāng)前場(chǎng)景下， cookie-parser 中間件大致實(shí)現(xiàn)如下：

app.use(function (req, res, next) {
 req.cookies = cookie.parse(req.headers.cookie);
 next();
});

進(jìn)階例子：cookie簽名與解析

出于安全的考慮，我們通常需要對(duì)cookie進(jìn)行簽名。

例子改寫如下，有幾個(gè)注意點(diǎn)：

1. cookieParser 初始化時(shí)，傳入 secret 作為簽名的秘鑰。

2. 設(shè)置cookie時(shí)，將 signed 設(shè)置為 true ，表示對(duì)即將設(shè)置的cookie進(jìn)行簽名。

3. 獲取cookie時(shí)，可以通過(guò) req.cookies ，也可以通過(guò) req.signedCookies 獲取。

var express = require('express');
var cookieParser = require('cookie-parser');
var app = express();
// 初始化中間件，傳入的第一個(gè)參數(shù)為singed secret
app.use(cookieParser('secret'));
app.use(function (req, res, next) {
 console.log(req.cookies.nick); // chyingp
 console.log(req.signedCookies.nick); // chyingp
 next();
});
app.use(function (req, res, next) { 
 // 傳入第三個(gè)參數(shù) {signed: true}，表示要對(duì)cookie進(jìn)行摘要計(jì)算
 res.cookie('nick', 'chyingp', {signed: true});
 res.end('ok');
});
app.listen(3000);

簽名前的cookie值為 chyingp ，簽名后的cookie值為 s%3Achyingp.uVofnk6k%2B9mHQpdPlQeOfjM8B5oa6mppny9d%2BmG9rD0 ，decode后為 s:chyingp.uVofnk6k+9mHQpdPlQeOfjM8B5oa6mppny9d+mG9rD0 。

下面就來(lái)分析下，cookie的簽名、解析是如何實(shí)現(xiàn)的。

cookie簽名、驗(yàn)證實(shí)現(xiàn)剖析

Express完成cookie值的簽名， cookie-parser 實(shí)現(xiàn)簽名cookie的解析。兩者共用同一個(gè)秘鑰。

cookie簽名

Express對(duì)cookie的設(shè)置（包括簽名），都是通過(guò) res.cookie() 這個(gè)方法實(shí)現(xiàn)的。

精簡(jiǎn)后的代碼如下：

res.cookie = function (name, value, options) { 
 var secret = this.req.secret;
 var signed = opts.signed;
 // 如果 options.signed 為true，則對(duì)cookie進(jìn)行簽名
 if (signed) {
 val = 's:' + sign(val, secret);
 }
 this.append('Set-Cookie', cookie.serialize(name, String(val), opts));
 return this;
};

sign 為簽名函數(shù)。偽代碼如下，其實(shí)就是把cookie的原始值，跟hmac后的值拼接起來(lái)。

敲黑板劃重點(diǎn)：簽名后的cookie值，包含了原始值。

function sign (val, secret) {
 return val + '.' + hmac(val, secret);
}

這里的 secret 哪來(lái)的呢？是 cookie-parser 初始化的時(shí)候傳入的。如下偽代碼所示：

var cookieParser = function (secret) {
 return function (req, res, next) {
 req.secret = secret;
 // ...
 next();
 };
};
app.use(cookieParser('secret'));

簽名cookie解析

知道了cookie簽名的機(jī)制后，如何"解析"簽名cookie就很清楚了。這個(gè)階段，中間件主要做了兩件事：

1. 將簽名cookie對(duì)應(yīng)的原始值提取出來(lái)

2. 驗(yàn)證簽名cookie是否合法

實(shí)現(xiàn)代碼如下：

// str：簽名后的cookie，比如 "s:chyingp.uVofnk6k+9mHQpdPlQeOfjM8B5oa6mppny9d+mG9rD0"
// secret：秘鑰，比如 "secret"
function signedCookie(str, secret) {

 // 檢查是否 s: 開(kāi)頭，確保只對(duì)簽過(guò)名的cookie進(jìn)行解析
 if (str.substr(0, 2) !== 's:') {
 return str;
 }

 // 校驗(yàn)簽名的值是否合法，如合法，返回true，否則，返回false
 var val = unsign(str.slice(2), secret);
 
 if (val !== false) {
 return val;
 }

 return false;
}

判斷、提取cookie原始值比較簡(jiǎn)單。只是是 unsign 方法名比較有迷惑性。

一般只會(huì)對(duì)簽名進(jìn)行合法校驗(yàn)，并沒(méi)有所謂的反簽名。

unsign 方法的代碼如下：

1. 首先，從傳入的cookie值中，分別提取出原始值A(chǔ)1、簽名值B1。

2. 其次，用同樣的秘鑰對(duì)A1進(jìn)行簽名，得到A2。

3. 最后，根據(jù)A2、B1是否相等，判斷簽名是否合法。

exports.unsign = function(val, secret){

 var str = val.slice(0, val.lastIndexOf('.'))
 , mac = exports.sign(str, secret);
 
 return sha1(mac) == sha1(val) ? str : false;
};

cookie簽名的作用

主要是出于安全考慮， 防止cookie被篡改 ，增強(qiáng)安全性。

舉個(gè)小例子來(lái)看下cookie簽名是如何實(shí)現(xiàn)防篡改的。

基于前面的例子展開(kāi)。假設(shè)網(wǎng)站通過(guò) nick 這個(gè)cookie來(lái)區(qū)分當(dāng)前登錄的用戶是誰(shuí)。在前面例子中，登錄用戶的cookie中，nick對(duì)應(yīng)的值如下：(decode后的)

s:chyingp.uVofnk6k+9mHQpdPlQeOfjM8B5oa6mppny9d+mG9rD0

此時(shí)，有人試圖修改這個(gè)cookie值，來(lái)達(dá)到偽造身份的目的。比如修改成 xiaoming ：

s:xiaoming.uVofnk6k+9mHQpdPlQeOfjM8B5oa6mppny9d+mG9rD0

當(dāng)網(wǎng)站收到請(qǐng)求，對(duì)簽名cookie進(jìn)行解析，發(fā)現(xiàn)簽名驗(yàn)證不通過(guò)。由此可判斷，cookie是偽造的。

hmac("xiaoming", "secret") !== "uVofnk6k+9mHQpdPlQeOfjM8B5oa6mppny9d+mG9rD0"

簽名就一定能夠確保安全嗎

當(dāng)然不是。

上個(gè)小節(jié)的例子，僅通過(guò) nick 這個(gè)cookie的值來(lái)判斷登錄的是哪個(gè)用戶，這是一個(gè)非常糟糕的設(shè)計(jì)。雖然在秘鑰未知的情況下，很難偽造簽名cookie。但用戶名相同的情況下，簽名也是相同的。這種情況下，其實(shí)是很容易偽造的。

上面是我整理給大家的，希望今后會(huì)對(duì)大家有幫助。

相關(guān)文章：

Vue組件通信（詳細(xì)教程）

Vue Socket.io源碼詳細(xì)分析

使用原生JavaScript實(shí)現(xiàn)放大鏡效果

聲明：本網(wǎng)頁(yè)內(nèi)容旨在傳播知識(shí)，若有侵權(quán)等問(wèn)題請(qǐng)及時(shí)與本網(wǎng)聯(lián)系，我們將在第一時(shí)間刪除處理。TEL:177 7030 7066 E-MAIL:11247931@qq.com