'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 ` 即可,见 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;