- backend/:Egg 3 纯 JSON 接口服务(MySQL 8 + Redis),全部走 header 令牌鉴权; 已彻底去掉服务端渲染(删除 page 控制器 / app/view / nunjucks / session / CSRF), 开发时把页面请求反代到前端 dev server,生产托管 frontend/dist(SPA 回退)。 单测 91 个通过(不需要本机数据库)。 - frontend/:Vite + Vue3 + TypeScript 的 SPA(登录 / 注册 / 找回密码 / 扫码登录与确认 / 首页统计 / 设备管理 / 扫码记录 / 个人中心 / 测试页),vue-tsc 类型检查与构建通过。 - extension/:MV3 浏览器扩展(零构建),注入第三方 WMS 页面识别运单号并打开溯源页。 - 忽略规则统一放根 .gitignore:node_modules、dist、logs / logs-*、run、typings、 .env*、config.local.js(含本机数据库与 Redis 密码,绝不入库)。
136 lines
4.6 KiB
JavaScript
136 lines
4.6 KiB
JavaScript
'use strict';
|
||
|
||
const { Service } = require('egg');
|
||
const jwt = require('jsonwebtoken');
|
||
|
||
/** 时长单位换算(秒):用于把 '30d' 这类写法解析成秒数,做上限校验 */
|
||
const DURATION_UNITS = { s: 1, m: 60, h: 3600, d: 86400, w: 604800, y: 31536000 };
|
||
|
||
/**
|
||
* JWT 服务:签发 / 校验令牌
|
||
*
|
||
* - **扫描器长期令牌**(typ=scanner,默认 1 年,见 config.jwt.scannerExpiresIn),
|
||
* 撤销靠库里存当前 jti + 扫描器 status 比对(见 app/middleware/scanner_auth.js):
|
||
* 重新注册/登录会换新 jti,旧令牌立即失效;status=0 或删除扫描器,令牌立即失效。
|
||
* - **用户令牌**(typ=user,默认 7 天,见 config.jwt.userExpiresIn):给前端(SPA / 小程序 / 扫码登录)
|
||
* 用,接口带 `Authorization: Bearer <token>` 即可,见 app/middleware/auth.js。
|
||
*/
|
||
class JwtService extends Service {
|
||
get secret() {
|
||
return this.config.jwt.secret;
|
||
}
|
||
|
||
/**
|
||
* 时长解析:`'30d'` / `'12h'` / `'90m'` / `'30s'` / `'2w'` / `'1y'` 或纯数字(秒)
|
||
* @param {string|number} value 时长
|
||
* @return {number} 秒数;解析不了返回 0
|
||
*/
|
||
parseDuration(value) {
|
||
if (value === undefined || value === null || value === '') return 0;
|
||
const text = String(value).trim();
|
||
if (/^\d+$/.test(text)) return Number(text);
|
||
|
||
const matched = /^(\d+)\s*([smhdwy])$/.exec(text.toLowerCase());
|
||
if (!matched) return 0;
|
||
return Number(matched[1]) * (DURATION_UNITS[matched[2]] || 0);
|
||
}
|
||
|
||
/**
|
||
* 签发用户令牌
|
||
* @param {object} user 至少含 id(可带 username)
|
||
* @return {string} JWT
|
||
*/
|
||
signUser(user) {
|
||
const payload = {
|
||
sub: String(user.id),
|
||
username: user.username || null,
|
||
typ: 'user',
|
||
};
|
||
|
||
return jwt.sign(payload, this.secret, {
|
||
algorithm: 'HS256',
|
||
expiresIn: this.config.jwt.userExpiresIn,
|
||
issuer: this.config.jwt.issuer,
|
||
audience: this.config.jwt.audience,
|
||
});
|
||
}
|
||
|
||
/**
|
||
* 校验用户令牌,失败返回 null(不抛错,调用方自己决定怎么响应)
|
||
* @return {object|null} payload(含 sub / typ / exp)
|
||
*/
|
||
verifyUser(token) {
|
||
try {
|
||
const payload = jwt.verify(token, this.secret, {
|
||
algorithms: [ 'HS256' ],
|
||
issuer: this.config.jwt.issuer,
|
||
audience: this.config.jwt.audience,
|
||
});
|
||
return payload && payload.typ === 'user' ? payload : null;
|
||
} catch (err) {
|
||
this.ctx.logger.warn('[jwt] 用户令牌校验失败(%s): %s', err.name, err.message);
|
||
return null;
|
||
}
|
||
}
|
||
/**
|
||
* 签发扫描器长期令牌
|
||
* @param {object} scanner 至少含 id、sn
|
||
* @param {object} extra 额外声明(如 jti)
|
||
* @param {object} options { expiresIn 覆盖有效期(秒数或 '30d' 这种写法,不传用 config.jwt.scannerExpiresIn) }
|
||
* @return {string} JWT
|
||
*/
|
||
signScanner(scanner, extra = {}, options = {}) {
|
||
const payload = Object.assign({
|
||
sub: String(scanner.id),
|
||
sn: scanner.sn,
|
||
typ: 'scanner',
|
||
}, extra);
|
||
|
||
return jwt.sign(payload, this.secret, {
|
||
algorithm: 'HS256',
|
||
expiresIn: options.expiresIn || this.config.jwt.scannerExpiresIn,
|
||
issuer: this.config.jwt.issuer,
|
||
audience: this.config.jwt.audience,
|
||
});
|
||
}
|
||
|
||
/**
|
||
* 校验扫描器令牌,失败直接抛 401
|
||
*
|
||
* ⚠️ 必须检查 `typ`:用户令牌与设备令牌用的是同一把密钥、同一对 issuer/audience,
|
||
* 不比对 `typ` 的话**用户令牌就能当设备令牌用**(用户 id 与设备 id 撞上号就出事)。
|
||
* @return {object} payload(含 sub / sn / jti / exp)
|
||
*/
|
||
verifyScanner(token) {
|
||
let payload;
|
||
try {
|
||
payload = jwt.verify(token, this.secret, {
|
||
algorithms: [ 'HS256' ],
|
||
issuer: this.config.jwt.issuer,
|
||
audience: this.config.jwt.audience,
|
||
});
|
||
} catch (err) {
|
||
const message = err.name === 'TokenExpiredError'
|
||
? '扫描器令牌已过期,请重新注册/登录'
|
||
: '扫描器令牌无效';
|
||
this.ctx.logger.warn('[jwt] 校验失败(%s): %s', err.name, err.message);
|
||
this.ctx.throw(401, message);
|
||
return null;
|
||
}
|
||
|
||
if (!payload || payload.typ !== 'scanner') {
|
||
this.ctx.logger.warn('[jwt] 拿到的不是设备令牌: typ=%s', payload && payload.typ);
|
||
this.ctx.throw(401, '不是设备令牌(设备接口只认 typ=scanner 的长期 JWT)');
|
||
}
|
||
return payload;
|
||
}
|
||
|
||
/** 取令牌的过期时间(存库/展示用) */
|
||
expiresAtOf(token) {
|
||
const decoded = jwt.decode(token);
|
||
return decoded && decoded.exp ? new Date(decoded.exp * 1000) : null;
|
||
}
|
||
}
|
||
|
||
module.exports = JwtService;
|