Express + JWT用户认证最轻实践

Express + JWT用户认证最轻实践

最近给自己列了一个list，Ummm...列来列去大概是下面这个样子：

• React SSR服务端渲染
• jwt用户认证
• Vue全家桶
• 微信小程序开发
• ... 等等

好吧，谁让自己菜呢，没什么好抱怨的，一个一个来吧。正好最近看了一些token做身份认证的文章，发现其中大部分都是说token登录怎么怎么好，反正没有几个认认真真的实现的。。。正好，秉着我是小白我怕谁的原则，继续分享一下express + jwt的填坑经历。为什么题目起名是最轻实践呢？因为确实看完这个你可以大概理解token登录的好处以及如何简单的实现一个前后端通过token进行认证的小系统。这个demo是在我第一篇文章那个脚手架上跑起来的，感兴趣的还可以回顾一下----->express-react-scaffold。具体实现就是下面这个样子：

• 不用token验证的页面正常浏览
• 需要验证的页面进行token验证
• 没有token信息或token信息过期，提示用户重新登录，跳转到登录页面
• 登录成功之后每次请求携带token信息

这篇文章包括

• 为什么要用token做身份验证（另一种模式是session）
• 前端http请求拦截器的设置
• 后端express + jsonwebtoken实现基于token的用户身份验证

token是个啥子东西

身份认证的两种方式

在前后端分离的系统中，身份认证是十分重要的，目前常用的两种身份认证方式如下：

• 基于cookie
  基于cookie的服务端认证，就是我们所熟知session，在服务端生成用户相关的 session 数据，而发给客户端 sesssion_id 存放到 cookie 中，这样用客户端请求时带上 session_id 就可以验证服务器端是否存在 session 数据，以此完成用户认证。
• 基于Token令牌
  基于 token 的用户认证是一种服务端无状态的认证方式，服务端不用存放 token 数据。用户验证后,服务端生成一个 token(hash 或 encrypt)发给客户端，客户端可以放到 cookie 或 localStorage(sessionStorage) 中，每次请求时在 Header 中带上 token ，服务端收到 token 通过验证后即可确认用户身份。

token认证的好处

• 体积小（一串字符串），因而传输速度快
• 传输方式多样，可以通过HTTP 头部（推荐）、 URL、POST 参数等方式传输严谨的结构化。它自身（在 payload 中）就包含了所有与用户相关的验证消息，如用户可访问路由、访问有效期等信息，服务器无需再去连接数据库验证信息的有效性，并且 payload 支持为应用定制化支持跨域验证，多应用于单点登录 充分依赖无状态 API ，契合 RESTful 设计原则（无状态的 HTTP）
• 用户登录之后，服务器会返回一串 token 并保存在本地也就是客户端，在这之后的对服务器的访问都要带上这串 token，来获得访问服务器相关路由、服务及资源的权限。 易于实现 CDN，将静态资源分布式管理
• 在传统的 session 验证中，服务端必须保存 session ID，用于与用户传过来的 cookie 验证。而一开始 sessionID 只会保存在一台服务器上，所以只能由一台 server 应答，就算其他服务器有空闲也无法应答，无法充分利用到分布式服务器的优点。 JWT 依赖的是在客户端本地保存验证信息，不需要利用服务器保存的信息来验证，所以任意一台服务器都可以应答，服务器的资源也被较好地利用。
• 对原生的移动端应用支持较好 原生的移动应用对 cookie 与 session 的支持不够好，而对 token 的方式支持较好。

JWT的组成

JWT的本质实际上就是一个字符串，它有三部分组成头部+载荷＋签名。

// Header
{
  "alg": "HS256",//所使用的签名算法
  "typ": "JWT"
}

// Payload
{
  //该JWT的签发者
  "iss": "luffy",
  // 这个JWT是什么时候签发的
  "iat":1441593502,
  //什么时候过期，这是一个时间戳
  "exp": 1441594722,
  // 接收JWT的一方
  "aud":"www.youdao.com",
  // JWT所面向的用户
  "sub":"any@126.com",
  // 上面是JWT标准定义的一些字段，除此之外还可以私人定义一些字段
  "form_user": "fsdfds"
}

// Signature 签名
将上面两个对象进行base64编码之后用.进行连接，然后通过HS256算法进行加密就形成了签名，一般需要加上我们提供的一个密匙，例如secretKey:'name_luffy'
const base64url = require('base64url')

const base64header = base64url(JSON.stringify(header));
const base64payload = base64url(JSON.stringify(payload));
const secretKey = 'name_luffy';
const signature = HS256(`${base64header}.${base64payload}`,secretKey);
// JWT
// 最后就形成了我们所需要的JWT:
const JWT = base64header + "." + base64payload + "." + signature;
// 它长下面这个样子：
// eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJmcm9tX3VzZXIiOiJCIiwidGFyZ2V0X3VzZXIiOiJBIn0.rSWamyAYwuHCo7IFAgd1oRpSP7nzL7BF5t7ItqpKViM
复制代码

JWT的工作原理

我从官网JWT.io拿下来的图来展示，就是下面这个过程，说的很详细，此外还有一些细节的东西，比如什么形式存储，放在头部哪里，客户端要存储在哪里等，官网都有比较详细的介绍，大家可以去看看。

 

前后端如何用这个东西做身份认证

思路

接下来要详细的说如何使用jwt来进行前后端的身份验证了，具体思路如下：

• 用户登录注册的逻辑不需要身份验证，因为没有用户的身份信息和登录状态；
• 用户登录之后后端生成token并返给前端，前端拿到token之后将token缓存在本地，可以使localStorage也可以是cookie，以便接下来使用。。
• 其他内容涉及到前后端交互的都需要前端把认证的token信息放在请求头部传给后端
• 后端收到请求先校验token，如果token合法（也就是token正确且没过期），则执行next()，否则直接返回401以及对应的message。

token登录的具体实现细节

• 后端：express-jwt + jsonwebtoken 首先，安装两个包

yarn add express-jwt jsonwebtoken 
复制代码

之后就是在登录环节生成token并且把token返回给前端

// /routes/user.js
if (user !== null) {
    // 用户登录成功过后生成token返给前端
  let token = jwt.sign(tokenObj, secretKey, {
        expiresIn : 60 * 60 * 24 // 授权时效24小时
  });
  res.json({
        success: true,
        message: 'success',
        token: token
  });
} 
复制代码

其次，设置拦截token的中间件，包括token的验证以及错误信息的返回：

// jwt.js,token中间件
const expressJwt = require("express-jwt");
const { secretKey } = require('../constant/constant');
// express-jwt中间件帮我们自动做了token的验证以及错误处理，所以一般情况下我们按照格式书写就没问题，其中unless放的就是你想要不检验token的api。
const jwtAuth = expressJwt({secret: secretKey}).unless({path: ["/api/user/login", "/api/user/register"]}); 

module.exports = jwtAuth;
复制代码

// constant.js
// 设置了密码盐值以及token的secretKey
const crypto = require('crypto');

module.exports = {
  MD5_SUFFIX: 'luffyZhou我是一个固定长度的盐值',
  md5: (pwd) => {
    let md5 = crypto.createHash('md5');
    return md5.update(pwd).digest('hex');
  },
  secretKey: 'luffy_1993711_26_jwttoken'
};
复制代码

最后在路由中间件前面放上jwt中间件

// routes/index.js
// 所有请求过来都会进行身份验证
router.use(jwtAuth);
// 路由中间件
router.use((req, res, next) => {
  // 任何路由信息都会执行这里面的语句
  console.log('this is a api request!');
  // 把它交给下一个中间件，注意中间件的注册顺序是按序执行
  next();
});
复制代码

后端逻辑部分全部完成，下面是前端的实现部分。

• 前端： axios拦截器 + localStorage存储token 前端主要做的就是两件事：

第一、把登陆成功之后返回的token存在客户端，可以使用localStorage也可以使用cookie，我看官方推荐使用localStorage，我这边也就用localStorage吧。 第二、每次请求把token放到header头部Authorization字段。

// axios拦截器
// 拦截请求，给所有的请求都带上token
axios.interceptors.request.use(request => {
  const luffy_jwt_token = window.localStorage.getItem('luffy_jwt_token');
  if (luffy_jwt_token) {
    // 此处有坑，下方记录
    request.headers['Authorization'] =`Bearer ${luffy_jwt_token}`;
  }
  return request;
});

// 拦截响应，遇到token不合法则报错
axios.interceptors.response.use(
  response => {
    if (response.data.token) {
      console.log('token:', response.data.token);
      window.localStorage.setItem('luffy_jwt_token', response.data.token);
    }
    return response;
  },
  error => {
    const errRes = error.response;
    if (errRes.status === 401) {
      window.localStorage.removeItem('luffy_jwt_token');
      swal('Auth Error!', `${errRes.data.error.message}, please login!`, 'error')
      .then(() => {
        history.push('/login');
      });
    }
    return Promise.reject(error.message);   // 返回接口返回的错误信息
  });
复制代码

此处有坑，在此记录request.headers['Authorization']必须通过此种形式设置Authorization，否则后端即使收到字段也会出现问题，返回401,request.headers.Authorization或request.headers.authorization可以设置成功，浏览器查看也没有任何问题，但是在后端会报401并且后端一律只能拿到小写的，也就是res.headers.authorization，后端用大写获取会报undefined.

 

 

可以看到，登录成功后，token被存放在localStorage里并且每一次请求都会将token放在头部Authorization字段内。如果我们把token从localStorage清除，再次访问就会报错。

 

 

总结

非常简单的一个小栗子，也没什么技术含量的文章，就当写着玩练习文笔了。代码没有另外放在哪？就在express-react-scaffold上增加的登录注册和token认证。可以通过/login来访问登陆部分逻辑以及token验证功能。 O(∩_∩)O哈哈~