packServer/backend/app/middleware/internal_auth.js
liufumingren bd2363bf00 chore: 初始化仓库(backend / frontend / extension 三块)
- 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 密码,绝不入库)。
2026-10-17 08:50:32 +08:00

75 lines
2.8 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'use strict';
/**
* 运维/内部接口鉴权(`/api/users*`、`/api/wechat/bind`、`/api/configs*`、`/api/scanners*` 这些)
*
* 用法:`router.get('/api/users', middleware.internalAuth(), controller.internal.user.index)`
*
* 两种通过方式(满足其一即可):
* 1. **运维脚本 / 后台系统**:header 带 `X-Internal-Token: <config.internal.token>`
* (环境变量 `INTERNAL_TOKEN`;**没配就一律不认**,避免线上忘记配还能进);
* 2. **管理员账号**:header 带 `Authorization: Bearer <user JWT>`,且 userId 在
* `config.internal.adminIds`(环境变量 `INTERNAL_ADMIN_IDS`,逗号分隔,默认 `1`)里。
*
* 通过后 `ctx.state.internal = { via, user? }`;不通过:401(没令牌/令牌无效)或 403(不是管理员、账号被禁用)。
*
* ⚠️ 这是**内部接口**(能看/改所有人的数据)。前端 SPA 用的是 `/api/web/*`(只能动自己的东西),
* 不要把它暴露给普通用户。
*/
module.exports = () => {
return async function internalAuth(ctx, next) {
const cfg = ctx.app.config.internal || {};
// ① 静态运维令牌(给脚本/后台系统用)
const internalToken = String(ctx.get('x-internal-token') || '').trim();
if (cfg.token && internalToken && internalToken === cfg.token) {
ctx.state.internal = { via: 'token' };
return next();
}
// ② 管理员账号的 user JWT
const bearer = bearerToken(ctx);
const payload = bearer && ctx.service.jwt.verifyUser(bearer);
const userId = payload && payload.sub ? Number(payload.sub) : 0;
if (!userId) {
ctx.status = 401;
ctx.body = {
ok: false,
status: 'unauthorized',
message: '内部接口需要管理员令牌(Authorization: Bearer <user JWT> 或 X-Internal-Token)',
};
return;
}
if (!(cfg.adminIds || []).includes(userId)) {
ctx.status = 403;
ctx.body = { ok: false, status: 'forbidden', message: '当前账号没有内部管理权限' };
return;
}
const user = await ctx.service.user.findById(userId);
if (!user) {
ctx.status = 401;
ctx.body = { ok: false, status: 'unauthorized', message: '令牌对应的用户不存在' };
return;
}
if (Number(user.status) !== 1) {
ctx.status = 403;
ctx.body = { ok: false, status: 'forbidden', message: '账号已被禁用' };
return;
}
ctx.state.internal = { via: 'user', user };
ctx.locals = ctx.locals || {};
ctx.locals.user = user;
await next();
};
};
/** 取 header 里的用户令牌:优先 Authorization: Bearer,其次 X-Access-Token */
function bearerToken(ctx) {
const matched = /^Bearer\s+(.+)$/i.exec(ctx.get('authorization') || '');
if (matched) return matched[1].trim();
return String(ctx.get('x-access-token') || '').trim();
}