您的位置：首页 > Web前端 > Node.js

Nodejs + Expressjs+ JWT，JWT使用

2017-11-29 19:38 267 查看

为什么要用研究JWT呢，一次关于用户token传递到讨论中，研发部的同事提到 SpringCloud 的zuul网关中引入 JWT，底层服务进行无状态处理，来实现我们之前关于token 传递的技术需求。

JWT(JSON Web Token),字面意思很好理解，就是Web的JSON令牌。一种通过Web可以安全传递JSON格式信息的机制。优势体量小，防串改，数据相对安全。可以用于客户端到服务器端重要用户数据保持，验证用户签名数据，也可以用于无状态服务的状态保持。（个人粗略理解），而我们项目要做的事情，就是用户登录后把用户当前操作的企业关系，以及用户id存储起来。通过网关将JWT解密后，有相关业务权限的API调用都是使用JWT中传递过来的参数进行权限校验。也可以参考JWT简介或者官方网站jwt.io

本人对SpringCloud zuul 网关的认知还是有限，于是就用Nodejs 对JWT进行了实践.本文参照这篇文章实践的。

首先是环境我使用的是expressjs+jsonwebtoken 还有一些类库morgan ，mongoose，body-parser ，测试代码包依赖如下

{"dependencies": {
"body-parser": "^1.17.2",
"express": "^4.15.3",
"express-jwt": "^5.3.0",
"jsonwebtoken": "^7.4.1",
"mongoose": "^4.10.4",
"morgan": "^1.8.2"
}}

会用Nodejs的，安装这些估计都没有问题。

写一个配置文件 config.js

module.exports = {
'network' : {
'port':8080
},
'jwtsecret': 'myjwttest',
'database': '你的mongo库链接或者其他'
};

实现简单的配置，然后是mongo数据库操作对象文件 user.js 返回User表对象

var mongoose = require('mongoose');
var Schema = mongoose.Schema;
// 返回一个mongo用户库实例
module.exports = mongoose.model('User', new Schema({
name: String,
password: String,
admin: Boolean   //要不要都行
}));

下来是写我们的主逻辑 index.js

1.引用

var express     = require('express');
var app         = express();
var bodyParser  = require('body-parser');
var morgan      = require('morgan');
var mongoose    = require('mongoose');
var jwt    = require('jsonwebtoken'); // 使用jwt签名
var config = require('./config'); // 引入配置
var User   = require('./user'); // 获得mongo用户库实例

2.基础应用开启

// mongo数据库设置
mongoose.connect(config.database);
// 设置superSecret 全局参数
app.set('superSecret', config.jwtsecret);
// 使用 body parser 将post参数及URL参数可以通过 req.body或req.query 拿到请求参数
app.use(bodyParser.urlencoded({ extended: false }));
app.use(bodyParser.json());
// 使用 morgan 将请求日志输出到控制台
app.use(morgan('dev'));
//根路径处理结果
app.get('/', function(req, res) {
res.send('JWT 授权访问的API路径 http://localhost:' + config.network.port + '/api');
});
//开启服务
app.listen(config.network.port);
console.log('JWT测试服务已经开启地址： http://localhost:' + config.network.port);

开启一个初始化express app 并开启一个express 应用。

3.用户数据写入

// 在steup 路径下简单用户数据写入操作，为了身份验证，当然也可以不使用数据库。
app.post('/setup', function(req, res) {
if(req.body.name && req.body.password){
var nick = new User({
name: req.body.name,
password: req.body.password,
admin:req.body.admin||false
});
nick.save(function(err) {
if (err) throw err;
console.log('用户存储成功');
res.json({ success: true });
});}
else{
res.json({ success: false,msg:"错误参数" });
}
});

简单写入

4.获取授权Token

// 用户授权路径，返回JWT 的 Token 验证用户名密码
app.post('/authenticate', function(req, res) {
User.findOne({
name: req.body.name
}, function(err, user) {
if (err) throw err;
if (!user) {
res.json({ success: false, message: '未找到授权用户' });
} else if (user) {
if (user.password != req.body.password) {
res.json({ success: false, message: '用户密码错误' });
} else {
var token = jwt.sign(user, app.get('superSecret'), {
expiresIn : 60*60*24// 授权时效24小时
});
res.json({
success: true,
message: '请使用您的授权码',
token: token
});
}
}
});
});

到了这一步，已经可以拿到jwt 的token 了，然后就可以通过token访问到下面要设定的API路径了。

5.API路由处理拦截验证JWT

//  localhost:端口号/api 路径路由定义
var apiRoutes = express.Router();
apiRoutes.use(function(req, res, next) {
// 拿取token 数据 按照自己传递方式写
var token = req.body.token || req.query.token || req.headers['x-access-token'];
if (token) {
// 解码 token (验证 secret 和检查有效期（exp）)
jwt.verify(token, app.get('superSecret'), function(err, decoded) {
if (err) {
return res.json({ success: false, message: '无效的token.' });
} else {
// 如果验证通过，在req中写入解密结果
req.decoded = decoded;
//console.log(decoded)  ;
next(); //继续下一步路由
}
});
} else {
// 没有拿到token 返回错误
return res.status(403).send({
success: false,
message: '没有找到token.'
});
}
});

6.JWT验证后操作

//API跟路径返回内容
apiRoutes.get('/', function(req, res) {
res.json({ message: req.decoded._doc.name+'  欢迎使用API' });
});
//获取所有用户数据
apiRoutes.get('/users', function(req, res) {
User.find({}, function(err, users) {
res.json(users);
});
});
// 注册API路由
app.use('/api', apiRoutes);