vue + koa2 实现 session | token 登录状态验证

Session 登录与 Token 登录的区别

一、Session 登录是在服务器端生成用户相关 session 数据，发给客户端 session_id 存放到 cookie 中，这样在客户端请求时带上 session_id 就能够验证服务器端是否存在 session 数据，以此完成用户认证。这种认证方式，能够更好的在服务端对会话进行控制，安全性比较高(session_id 随机），可是服务端须要存储 session 数据(如内存或数据库），这样无疑增长维护成本和减弱可扩展性(多台服务器)。 CSRF 攻击通常基于 cookie。另外，若是是原生 app 使用这种服务接口，由于没有浏览器 cookie 功能，因此接入会相对麻烦。
二、基于 token 的用户认证是一种服务端无状态的认证方式，服务端不用存放 token 数据。用户验证后,服务端生成一个 token(hash 或 encrypt)发给客户端，客户端能够放到 cookie 或 localStorage 中，每次请求时在 Header 中带上 token，服务端收到 token，经过验证后便可确认用户身份。这种方式相对 cookie 的认证方式就简单一些，服务端不用存储认证数据，易维护扩展性强，token 存在 localStorage 可避免 CSRF，web 和 app 应用都比较简单。不过这种方式在加密或解密的时候会有一些性能开销(好像也不是很大)，有些对称加密存在安全隐患(aes cbc 字节翻转攻击)。

koa + session 登录验证

一、首先要安装 koa-sisson 包

npm install koa-session -S

koa-session 其实是经过 cookie 来保存信息的。koa-session 在服务器上生成一个信息，经过加密后，以 cookie 的形式发送到用户的浏览器，在用户浏览器上能够看到是一个加密的 cookie 字段，而后在服务端路由中经过 ctx.session.xx 来获取 xx 这个信息。而当每次当用户发送请求时候，就能够获取到这个 cookie，koa-sesscion 会内部会帮咱们解密为最初的存储的信息，因而咱们能够经过判断这个 cookie 是存在来校验用户是否已经登陆了。

二、app.js 中初始化

const Koa = require('koa')
const app = new Koa()
const session = require('koa-session')
const bodyParser = require('koa-bodyparser')
const Router = require('koa-router')
const router = new Router()

const CONFIG = {
  key: 'koa:sess', /** (string) cookie key (default is koa:sess) cookie 的Name */
  /** (number || 'session') maxAge in ms (default is 1 days) */
  /** 'session' will result in a cookie that expires when session/browser is closed */
  /** Warning: If a session cookie is stolen, this cookie will never expire */
  maxAge: 86400000, /** cookie 的过时时间 */
  autoCommit: true, /** (boolean) automatically commit headers (default true) */
  overwrite: true, /** (boolean) can overwrite or not (default true) */
  httpOnly: true, /** (boolean) httpOnly or not (default true) */
  signed: true, /** (boolean) signed or not (default true) */
  rolling: false, /** (boolean) Force a session identifier cookie to be set on every response. The expiration is reset to the original maxAge, resetting the expiration countdown. (default is false) */
  renew: false, /** (boolean) renew session when session is nearly expired, so we can always keep user logged in. (default is false)*/
}
app.keys = ['login secret'] // 加密密钥
app.use(session(CONFIG, app));

app.use(bodyParser())
app.use(router.routes()).use(router.allowedMethods())

三、登录路由

router.post('/login', async (ctx) => {
  try {
    const data = ctx.request.body.data
    const { username, password } = data
    if (true) {
      // 保存登陆状态，这句代码会在浏览器中生成一个以 "koa:sess" 为 Name 的 cookie
      ctx.session.userInfo = {username: '', userID: ''}
      ctx.body = {code: 1, message: '登录成功'}
    } else {
      ctx.body = {code: 0, message: '帐号或密码错误'}
    }
  } catch(err) {
    throw new Error(err)
  }
})

// 前端
axios.post('/login', {username: '', password: ''}).then(res => {})

四、校验是否已登录

router.get('/getSession', async (ctx) => {
  try {
    if (ctx.session.userInfo) {
      ctx.body = {code: 1, message: '已登录'}
    } else {
      ctx.body = {code: 0, message: '未登录'}
      // 跳转到登陆页
      // ctx.response.redirect('/login') 
    }
  } catch(err) {
    throw new Error(err)
  }
})

// 前端
axios.get('/getSession').then(res => {})

五、退出登录

router.post('/logout', async (ctx) => {
  try {
    // 将登陆信息清空
    ctx.session = null
    // 跳转到登陆页或网站首页
    ctx.response.redirect('/')
  } catch(err) {
    throw new Error(err)
  }
})

// 前端
axios.post('/logout').then(res => {})

koa + token 登录验证

一、安装 jsonwebtoken 包

npm install jsonwebtoken -S

二、app.js 初始化

const Koa = require('koa')
const app = new Koa()
const jwt = require('jsonwebtoken')
const bodyParser = require('koa-bodyparser')
const Router = require('koa-router')
const router = new Router()
const tokenConfig = {privateKey: 'xxxxxxxxxxxx'} // 加密密钥

app.use(bodyParser())
app.use(router.routes()).use(router.allowedMethods())

三、登录路由

router.post('/login', async (ctx) => {
  try {
    const data = ctx.request.body.data
    const { username, password } = data
    if (true) {
      const userInfo = {username: '', userID: ''}
      const token = jwt.sign(userInfo, tokenConfig.privateKey, {expiresIn: '7d'}) // 签发 token， 7天有效期
      ctx.body = {code: 1, message: '登录成功', data: {token: 'Bearer ' + token}}
    } else {
      ctx.body = {code: 0, message: '帐号或密码错误'}
    }
  } catch(err) {
    throw new Error(err)
  }
})

前端登录

axios.post('/login', {username: '', password: ''}).then(res => {
  if (res.data.code === 1) {
    localStorage.setItem('token', res.data.data.token)
    // vuex 存储 userInfo 和登录状态
    store.commit('SET_USERINFO', {userInfo: res.data.data.userInfo, status: true})
  }
})

四、校验是否已登录

router.get('/getUserInfo', async (ctx) => {
  try {
    const token = ctx.get('Authorization') // 获取请求 Header 中 Authorization 值
    let userInfo = {}
    if (token === '') {
      ctx.body = {code: 0, message: '未登录'}
    } else {
      try {
        userInfo = jwt.verify(token.split(' ')[1], tokenConfig.privateKey) // 验证 token
        ctx.body = {code: 1, message: '已登录', data: {userInfo: userInfo: loginStatus: true}}
      } catch(err) {
        // token 过时或无效
        ctx.body = {code: 0, message: '未登录', data: {userInfo: {}: loginStatus: false}}}
      }
    }
  } catch(err) {
    throw new Error(err)
  }
})

要每次的请求中都带上 token 信息，要给 axios 设置请求拦截

// 请求拦截，在每次请求中的 header 中带上 token
axios.interceptors.request.use(config => {
  let token = localStorage.getItem('token')
  if (token) {
    config.headers.common.Authorization = token
  }
  return config
}, error => {
  return Promise.reject(error);
})

每次进入页面以前要判断下是否已登录，是否有权限进入该页面，以前我是在每一个页面的 created 钩子函数中去请求 '/getUserInfo' 判断是否以登录，这样作繁琐，而且页面会先呈现一下，而后一闪而过（验证不过的状况下），在路由钩子函数中可全局配置

// 路由守卫， 在跳转以前执行
router.beforeEach((to, from, next) => {
  let token = localStorage.getItem('token')
  let requireAuth = to.meta.requireAuth // VueRouter 里配置页面是否须要登录进入
  let root = to.meta.root // VueRouter 里配置页面是否须要登录且管理员权限进入
  if (!token) {
    // vuex 清除 userInfo 和登录状态
    store.commit('SET_USERINFO', {userInfo: {}, status: false})
    requireAuth ? next({path: '/'}) : next()
  } else {
    axios.get(API.getUserInfo).then(res => {
      // vuex 存储 userInfo 和登录状态
      store.commit('SET_USERINFO', {userInfo: res.data.userInfo, status: res.data.loginStatus})
      if (requireAuth) {
        if (!res.data.loginStatus || (root && !res.data.userInfo.root)) {
          next({path: '/'})
        } else {
          next()
        }
      } else {
        next()
      }
    })
  }
})

/** VueRouter
{
  path: '/admin',
  name: 'admin',
  meta: {
    requireAuth: true,
    root: true
  },
}
*/

五、退出登录

由于服务器端并无存储用户登录相关信息，只与前端是否存在 token 或是否能验证经过有关，因此退出登录就将 token 清除便可

methods: {
  logout() {
    localStorage.removeItem('token')
    // vuex 清除登录信息
    store.commit('SET_USERINFO', {userInfo: {}, status: false})
    if (this.$route.path !== '/') {
      this.$router.push({path: '/'})
    }
  }
}

程序员词汇学习网：www.english4coder.com