Vue 安全权限控制 axios 拦截

Question

何为权限控制

//请求失败后的统一拦截，以及ajax的基本设置
import axios from 'axios';
import qs from 'qs';

function cleanRequest(req) {
  for (const i in req) {
    /* eslint guard-for-in: 0 */
    if (req[i] !== 0 && !req[i]) {
      delete req[i];
    }
  }
}

axios.defaults.withCredentials = true;
axios.defaults.xsrfCookieName = null;
axios.defaults.headers.common['X-Requested-With'] = 'XMLHttpRequest';
axios.defaults.headers.post['Content-Type'] = 'application/x-www-form-urlencoded';
//系统弹层
import Toast from 'mint-ui/lib/toast';
import 'mint-ui/lib/toast/style.css';

module.exports.install = function (Vue) {
  axios.defaults.baseURL="/";
  Vue.prototype.$http = axios;
  Vue.http = axios;

  axios.interceptors.request.use(
    function (request) {
      const params = request.params;
      if (params) {
        cleanRequest(params);
      }
      if (request.data) {
        cleanRequest(request.data);
        request.data=qs.stringify(Object.assign(request.data,Bus.movieConfig))
      }else{
        request.data=qs.stringify(Bus.movieConfig)
      }
      return request;
    },
    function (error) {
      return Promise.reject(error);
    }
  );

  // Add a response interceptor
  axios.interceptors.response.use(
    function (response) {
      return response;
    },
    function (error) {
      Toast('系统繁忙，请稍后重试!');
      // Do something with response error
      return Promise.reject(error);
    }
  );
};

权限控制大致分为两个维度

• 垂直维度: 控制用户可以访问哪些url的权限
• 水平维度: 控制用户访问特定 url，获取哪些数据的权限（e.g. 普通用户、管理员、超级管理员访问同一url，获取的数据是不同的）

Web 权限控制方案 List

• 前后端不分离：以 Java 为例，后端通过 jsp、freemark、thmeleaf 等模板来渲染相应权限的数据，渲染完呈现在浏览器端
• 前后端分离：
  SPA 单页面应用，路由由前端控制，前端通过 js 控制 hash 路由的权限
  SSR 服务端渲染，Node 中间层做代理路由，判断权限渲染特定的路由至浏览器端

SPA 前端权限控制方案

SPA 单页 Web 应用（single page web application）将所有 Web 活动局限于一个 html 页面中，利用 js 通过 hash 或者浏览器 history api 来实现无刷新路由跳转，前后端通过ajax数据通信，避免了浏览器的刷新重新加载，为用户提供流程的操作体验。这意味着前端接管了路由层，需要通过调用前端自身的 MVC 模块，来渲染不同的页面。

Base on：

• Vue 前端MVVM框架
• Vuex 状态管理机
• Vue-router 路由
• Axios HTTP请求库

1.登陆事件 Login

// 1.触发登陆事件
dispatch('login')
 
// actions
commit(types.LOGIN_SUCCESS, res.data.data)
...

2.获取 Token，经 Base64 编码后存至 sessionStorage

// mutations
const mutations = {
    [types.LOGIN_SUCCESS] (state, data) {
        state.authlock = false
    // 2.登陆成功回调拿到token,经Base64 编码后存入本地sessionStorage
        let token = Base64.encode(data + ':HIKDATAE')
        sessionStorage.setItem('userToken', token)
    // 路由跳转至目标页面
        router.push({name: 'xxx'})
    },
    [types.LOGOUT_SUCCESS] (state) {
        state.authlock = true
    // 登出成功回调,移除本地token
        sessionStorage.removeItem('userToken')
        router.push({name: 'Login'})
    }
}

3.所有 HTTP Header Authorization 加上编码后的 token（前后端可约定规则）

// Axios 请求钩子（request）
axios.interceptors.request.use(req => {
    let token = sessionStorage.getItem('user')     
    if (token) {         
        // 3.token 存在,则在之后所有请求的http请求头 Authorization 带上base64编码后的token,后台拿到token后进行验证权限         
        req.headers.Authorization = `Basic ${token}`     
    }
    req.data = qs.stringify(req.data)     
    return req 
}, error => {
    return Promise.reject(error) 
})

浏览器 http header

4.请求拦截：后台拿到 token 后对每个请求进行校验，若校验失败返回 401，前端 response 钩子里统一 catch error 跳转至登陆页面。

// Axios 请求钩子（response）
axios.interceptors.response.use(res => {
    return res
}, error => {
    if (error.response) {
        switch (error.response.status) {
        // 4.所有接口response校验钩子,若token检验失败,后台返回 401 error code, 清除token信息并跳转到登录页面
            case 401:
                store.commit(types.LOGOUT)
                router.replace({
                    path: '/login'
        })
    }
    }
    return Promise.reject(error)
})

5.路由跳转拦截：任意路由跳转时，在路由 beforeEach 钩子里校验本地是否存在 token，若没有，则跳转至登陆页面

// 路由钩子(每个路由跳转前调起beforeEach钩子)
router.beforeEach((to, from, next) => {
  if (to.path === '/login') {
    sessionStorage.removeItem('userToken')
  }
  let user = sessionStorage.getItem('userToken')
  if (!user && to.path !== '/login') {
    // 若本地token不存在,则任意路由跳转的时候,重定向至login 登陆页面
    next({ path: '/login' })
  } else {
    next()
  }
})

6.登出 Logout：清楚本地 sessionStorage 的 token 信息

// mutations
const mutations = {
    ...
    [types.LOGOUT_SUCCESS] (state) {
        state.authlock = true
    // 登出成功回调,移除本地token
        sessionStorage.removeItem('userToken')
    router.push({name: 'Login'})
    }
}

流程示意图如下: