- 登录/邮箱验证码/密码流程(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 表
72 lines
2.9 KiB
JavaScript
72 lines
2.9 KiB
JavaScript
'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();
|
||
};
|
||
};
|