'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(); }; };