koa2服務端使用jwt進行鑒權及路由權限分發

大體思路

　　后端書寫REST api時，有一些api是非常敏感的，比如獲取用戶個人信息，查看所有用戶列表，修改密碼等。如果不對這些api進行保護，那么別人就可以很容易地獲取並調用這些 api 進行操作。

　　所以對於一些api，在調用之前，我們在服務端必須先對操作者進行“身份認證”，這就是所謂的鑒權。

　　Json Web Token 簡稱為 JWT，它定義了一種通信雙方之間以 JSON 對象的形式安全傳遞信息的方法。JWT 可以使用 HMAC 算法或者是 RSA 的公鑰密鑰對進行簽名，復雜度較高，換來的是更可靠的安全系數。

　　整個認證的流程大體如下：

　　首先用戶登錄的接口是不用token認證的，因為這個接口本身就是token的產生來源。前端輸入用戶名和密碼后請求服務器登錄接口，服務器驗證用戶名密碼正確后，生成token並返回給前端，前端存儲token，並在后面的請求中把token帶在請求頭中傳給服務器，服務器驗證token有效，才可以進行下一步操作。

 

服務器生成token

　　由於我們的服務端使用 Koa2 框架進行開發，除了要使用到 jsonwebtoken 庫之外，還要使用一個 koa-jwt 中間件，該中間件針對 Koa 對 jsonwebtoken 進行了封裝，使用起來更加方便。

　　

const router = require('koa-router')();
const jwt = require('jsonwebtoken');
const userModel = require('../models/userModel.js');

router.post('/login', async (ctx) => {
    const data = ctx.request.body;const result = await userModel.findOne({
        name: data.name,
        password: data.password
    })
    if(result !== null){
        const token = jwt.sign({
            name: result.name,
            _id: result._id
        }, 'zhangnan', { expiresIn: '2h' });
        return ctx.body = {
            code: 200,
            token: token,
            msg: '登錄成功'
        }
    }else{
        return ctx.body = {
            code: 400,
            token: null,
            msg: '用戶名或密碼錯誤'
        }
    }
});
module.exports = router;

　　（注意：這里暫時不討論加鹽加密校驗，實際項目中密碼不可能這樣明文驗證，這里只是為了着重討論token鑒權。在驗證了用戶名密碼正確之后，就可以調用 jsonwebtoken 的 sign() 方法來生成token，接收三個參數，第一個是載荷，用於編碼后存儲在 token 中的數據，也是驗證 token 后可以拿到的數據；第二個是密鑰，自己定義的，隨便寫個什么單詞都可以，但是驗證的時候一定要相同的密鑰才能解碼；第三個是options，可以設置 token 的過期時間。）

　　

前端獲取token

　　接下來就是前端獲取 token，這里是在 vue.js 中使用 axios 進行請求，請求成功之后拿到 token 保存到 localStorage 中。

　　

submit(){
    axios.post('/login', {
        name: this.username,
        password: this.password
    }).then(res => {
        if(res.code === 200){
            localStorage.setItem('token', res.data.token);
        }else{
            this.$message('登錄失敗')
        }
    })
}

　　然后前端在請求后端api時，就把 token 帶在請求頭中傳給服務器進行驗證。每次請求都要獲取 localStorage 中的 token，這樣很麻煩，這里使用了 axios 的請求攔截器，進行全局設置，對每次請求都進行了取 token 放到 headers 中的操作。

axios.interceptors.request.use(config => {
    const token = localStorage.getItem('token');
    config.headers.common['Authorization'] = 'Bearer ' + token;
    return config;
})

（這段代碼，如果是vue項目，可以直接放在main.js中設置，表示每次請求前都會往請求頭的authorization里塞一個token，至於那個Bearer 是koa-jwt的一個標識單詞，方便解析）

  

服務器驗證token

　　接下來服務器收到前端發過來的token后，就可以進行驗證。

const koa = require('koa');
const koajwt = require('koa-jwt');
const app = new koa();

app.use(koajwt({
    secret: 'zhangnan'
}).unless({
     path: [/\/register/, /\/login/]
}));

（在這里沒有定義錯誤處理函數，由於出現錯誤后會返回401，所以我直接就讓前端來處理這種異常情況，給出一個錯誤的交互提示即可）

 

分析koa-jwt源碼

　　我們在node_mudules里面找到koa-jwt/lib/resolvers文件夾下的auth-header.js文件，看下koa-jwt做了些什么

　　（可以看到它是先判斷請求頭中是否帶了 authorization，如果有，則通過正則將 token 從 authorization 中分離出來，這里我們也看到了Bearer這個單詞。如果沒有 authorization，則代表了客戶端沒有傳 token 到服務器，這時候就拋出 401 錯誤狀態。）

　　再看看上一級的vertify.js。

　　

　　（可以看到在 verify.js 中，它就是調用 jsonwebtoken 原生提供的 verify() 方法進行驗證返回結果。jsonwebtoken 的 sign() 方法用於生成 token ，而 verify() 方法當然則是用來解析 token。屬於jwt配對生產的兩個方法，所以koa-jwt這個中間件也沒做什么事，無非就是用正則解析請求頭，調用jwt的vertify方法驗證token，在koa-jwt文件夾的index.js中，koa-jwt還調用koa-unless進行路由權限分發）

　　以上就是json web token的大體流程。