JWT 鉴权

使用 koa-jwt + jsonwebtoken 完成用户鉴权功能。
项目地址：https://github.com/Ewall1106/mall

安装

• 首先我们安装 koa-jwt 和 jsonwebtoken这两个 npm 包。

$ npm install koa-jwt jsonwebtoken --save

• 先明确一下两者的关系：koa-jwt 是负责对 token 进行验证的，而 jsonwebtoken 是负责生成 token 的。

JWT 鉴权

• 在 app.js 中引入并使用。

const Koa = require('koa');
const jwt = require('koa-jwt');

const app = new Koa();

// 1. 错误信息处理
app.use(async (ctx, next) => {
  return next().catch((err) => {
    if (401 == err.status) {
      ctx.body = {
        code: 50001,
        message: '用户鉴权失败',
      };
    } else {
      throw err;
    }
  });
});

// 2. 中间件注册
app.use(jwt({ secret: JWT_SECRET }).unless({ path: [/^\/public/, /\/login/] }));

• 第 1 处是定义了当鉴权失败的时候，koa 服务返回的一些内容。

• 第 2 处就是 koa-jwt 这个中间件的注册。

  • 其中 JWT_SECRET 是一个加密因子，可以提升安全性，你也可以设置成123456，但是为了更安全点推荐用密钥生成器生成一段密钥。
  • 后面的 path 路径是设置匹配不需要鉴权的路由或目录，比如我这里设置了所有的 public 开头的、登录 xxxx/login 的请求都不需要鉴权。

Token 生成

• 还是前面说到的，koa-jwt 是负责对 token 进行验证的，而 jsonwebtoken 是负责生成 token 的，所以接下来看我们如何进行 token 的生成。

// controller/UserController.js
const jwt = require('jsonwebtoken');

async login(ctx, next) {
  // ...
  // 在登录成功后
  const token = jwt.sign({ uid: user._id }, JWT_SECRET, { expiresIn: '15d' });
  ctx.body = {
    code: 200,
    entry: {
      token: token
    },
  };
},

• 如上，利用 jsonwebtoken 这个库，其实 token 的生产很简单。

  • { uid: user._id } 就是一个 payload 数据载体，就是你可以放些参数在 token 中，比如用户的 id。
  • JWT_SECRET 就是前面提到的加密因子，要跟 koa-jwt 设置的保持一致。
  • expiresIn 设置 token 的过期时间。

• 至此，服务端的鉴权主要功能就完成了。

前端设置

• 在前端，首先我们需要登录的时候获取这个 token，然后把它放到 vuex 中或者本地缓存起来。

// 登录
login(loginInfo).then((res) => {
  const { token } = res.entry;
  console.log('token', token);
});

• 在 axios 请求拦截器中设置 Authorization 鉴权头，每次请求的时候都带上 token 值。

// src/utils/request.js

// 请求拦截器
service.interceptors.request.use(
  (config) => {
    if (store.getters.token) {
      // JWT鉴权
      config.headers.Authorization = `Bearer ${getToken()}`;
    }
    return config;
  },
  (error) => {
    console.log(error);
    return Promise.reject(error);
  }
);

• 然后服务端的 koa-jwt 就会通过读 Authorization 这个 header 头中的 token 值来进行比对校检鉴权了。

• 至此，我们使用 koa-jwt + jsonwebtoken 完成了用户鉴权功能，具体代码实现请移步项目仓库中。