packServer/backend/app/middleware/internal_auth.js

81 lines
3.1 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;
}
// 改密 / 重置密码之后,签发时间更早的旧令牌立即失效(与 api_auth 同一套规则)
if (ctx.service.user.isTokenStale(user, payload.iat)) {
ctx.status = 401;
ctx.body = { ok: false, status: 'password_changed', 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();
}