Egg框架搭建后端服务【5】- 接口token

李剑一

于 2024-01-18 15:15:48 发布

阅读量634

点赞数 7

分类专栏： Egg 文章标签： egg

本文链接：https://blog.csdn.net/feng_ye__/article/details/135674784

版权

Egg 专栏收录该内容

6 篇文章 0 订阅

订阅专栏

本文详细介绍了如何在Egg.js应用中使用egg-jwt插件处理后端接口的权限控制，包括安装、配置、生成token、校验过程以及注意事项，特别强调了使用JWT进行身份验证的W3C规范遵循。

摘要由CSDN通过智能技术生成

需求

后端服务提供的接口应该是有时限和权限的，所以一般通过 token 进行用户权限的校验。

开发

安装

通过 egg-jwt 插件生成 token。

npm i --save egg-jwt

配置

在 plugin.js 中配置 egg-jwt 插件。

module.exports = {
    jwt: {
        enable: true,
        package: 'egg-jwt'
    },
};

在 config.default.js 中设置 jwt 相关内容，同时因为部分接口不需要校验 token，故在此处同时设置白名单。

// 添加jwt的配置
config.jwt = {
	secret: 'Jian1',  // 加密密钥
	sign: {
		expiresIn: 60 * 60 * 24,  // 过期时间24小时
		algorithm: 'HS256'
	}
}

// 添加token白名单配置
config.tokenWhiteList = [
	'/login',
	'/verifyCode',
]

生成

生成 token 的动作一般在调用 login 接口的时候进行，通过 login 接口将 token 传递给前端，一般保存在 localStore 中。

const token = app.jwt.sign(params, app.config.jwt.secret);
ctx.state = 200;
ctx.body = {
	code: 200,
	success: true,
	data: {token: token},
	msg: '欢迎回来，' + userInfo.name,
	show: true	
}

校验

egg框架存在中间件(middleware) 非常适合全局性质的拦截和校验。

创建 app/middleware/tokenAuth.js 文件。

module.exports = () => {
    return async function (ctx, next) {
        const requestUrl = ctx.request.url;

        if (ctx.app.config.tokenWhiteList.indexOf(requestUrl) > -1) {
            // 当前路由在白名单中
            await next();
            return;
        }

        const userToken = ctx.request.headers['authorization'].replace(/^Bearer\s+/, '');

        if (userToken) {
            try {
                ctx.app.jwt.verify(userToken, ctx.app.config.jwt.secret);
                await next();
            } catch (e) {
                ctx.status = 401;
                return ctx.body = {
                    code: 401,
                    msg: 'token错误'
                }
                return;
            }
        } else {
            ctx.status = 401;
            return ctx.body = {
                code: 401,
                msg: 'token不存在'
            }
            return;
        }
    }
}