oms/backend/app/middleware/principal_check.js
liufumingren 8597cf5ac9 feat(backend): 用户鉴权、菜单权限、主体与系统基础模块
- 登录/邮箱验证码/密码流程(controller/auth.js、lib/emailCode.js、middleware/jwt_auth.js)
- 主体(principal)隔离与主体用户、对外接口配置模块及 principalCheck 中间件
- 菜单、用户、文件上传、快递公司字典(express_companies)等基础模块
- 通用工具:分页(lib/pagination.js)、缓存(service/cache.js)
- 全量接口契约(contract/index.js)与路由注册(router.js)、config.default.js 配置
- 相关迁移:菜单组件调整与菜单种子、创建 files 表
2026-09-13 02:23:34 +08:00

72 lines
2.9 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';
/**
* 主体校验中间件(防跨主体操作)
* 适用于“需要传入/关联主体ID(principal_id)”的请求:
* - 取不到可校验的主体ID -> 400
* - 当前账号未与该主体绑定(principal_users 无记录)-> 403
* 校验通过后把 principalId 写入 ctx.state.principalId,供控制器做数据隔离(列表过滤、创建归属)。
*
* 解析与鉴权规则:
* - 资源详情/更新/删除(带 :id 且配置了 model):以“资源记录本身的 principal_id”为准做鉴权,
* 忽略请求体里的 principal_id,防止通过篡改请求体越权访问/移动其它主体的数据。
* - 列表/新建(无 :id):以请求入参(body / query)里的 principal_id 为准。
*
* @param {Object} options 中间件配置项
* @param {string} [options.model] 资源模型名,如 'Product',用于按 :id 反查资源所属主体
* @return {Function} koa 中间件
*/
module.exports = (options = {}) => {
const modelName = options.model;
return async (ctx, next) => {
const userId = ctx.userId;
if (!userId) {
ctx.status = 401;
ctx.body = { code: 401, message: '缺少登录凭证,请先登录' };
return;
}
let principalId = null;
let recordMissing = false;
if (modelName && ctx.params && ctx.params.id != null) {
// 资源按 id 访问:以记录真实的 principal_id 鉴权
const Model = ctx.model[modelName];
if (Model) {
const record = await Model.findByPk(ctx.params.id, { attributes: [ 'principal_id' ] });
if (record) principalId = record.principal_id;
else recordMissing = true; // 资源不存在,交给控制器返回 404,无需主体校验
}
} else {
// 列表/新建:从入参取主体ID
const body = ctx.request.body || {};
const q = ctx.query || {};
const p = ctx.params || {};
if (body.principal_id != null) principalId = body.principal_id;
else if (q.principal_id != null) principalId = q.principal_id;
else if (p.principal_id != null) principalId = p.principal_id;
else principalId = null;
}
if (principalId == null || principalId === '') {
if (recordMissing) return await next();
ctx.status = 400;
ctx.body = { code: 400, message: '缺少主体ID(principal_id)' };
return;
}
principalId = Number(principalId);
// 校验账号与主体的绑定关系:主体ID列表来自缓存(JWT 中间件已加载),避免每次请求查关联表
const principalIds = ctx.state.principalIds || await ctx.service.cache.getUserPrincipalIds(userId);
const bound = new Set((principalIds || []).map(Number)).has(principalId);
if (!bound) {
ctx.status = 403;
ctx.body = { code: 403, message: '无权操作该主体下的数据' };
return;
}
ctx.state.principalId = principalId;
await next();
};
};