'use strict'; /** * 主体校验中间件(防跨主体操作) * 适用于“需要传入/关联主体ID(principal_id)”的请求: * - 取不到可校验的主体ID -> 400 * - 当前账号未与该主体绑定(principal_users 无记录)-> 403 * - 主体已停用(principals.status=0)-> 只允许读(GET/HEAD/OPTIONS)与导出,其余写操作 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; // 主体停用:数据只读(可查看 / 导出),写操作一律拒绝 const principal = await ctx.service.cache.getPrincipal(principalId); if (!principal) { ctx.status = 404; ctx.body = { code: 404, message: '主体不存在' }; return; } const disabled = Number(principal.status) !== 1; ctx.state.principalDisabled = disabled; if (disabled && !isReadOnlyRequest(ctx)) { ctx.status = 403; ctx.body = { code: 403, message: '主体已停用,仅可查看与导出,不能新建、修改、推送或删除数据' }; return; } await next(); }; }; /** 只读方法(不改变数据) */ const READ_METHODS = new Set([ 'GET', 'HEAD', 'OPTIONS' ]); /** * 停用主体下仍允许的“读”请求 * - 常规 GET/HEAD/OPTIONS * - 导出任务提交(POST /api/export-tasks):属于查看数据,按主体停用策略放行 * @param {Object} ctx koa 上下文 * @return {boolean} 是否放行 */ function isReadOnlyRequest(ctx) { if (READ_METHODS.has(ctx.method)) return true; if (ctx.method === 'POST' && ctx.path === '/api/export-tasks') return true; return false; }