import { DBModel } from '../models/index.js'; import ResponseUtil from '../utils/api_response.js'; import { hashToken } from '../utils/crypto.js'; /** * 从请求中提取 token(优先 Authorization header) */ function extractToken(ctx) { // 优先从 Authorization: Bearer xxx 获取 const authHeader = ctx.header?.authorization; if (authHeader && authHeader.startsWith('Bearer ')) { return authHeader.slice(7); } // 兼容旧方式:body/query/header 中的 token 字段 return ctx.request.body?.token || ctx.request.query?.token || ctx.header?.token; } /** * 按 token 查找用户 * DB 中存储的是 token 的 sha256 哈希;兼容旧明文 token,命中后自动迁移为哈希 * 多端会话:命中 security.tokens 中任意一条即可,同时兼容旧的单 token 字段 */ async function findUserByToken(rawToken) { const hashed = await hashToken(rawToken); let user = await DBModel.User.findOne({ $or: [ { 'security.tokens.hash': hashed }, { 'security.token': hashed }, ], }); if (!user) { // 兼容旧明文 token user = await DBModel.User.findOne({ 'security.token': rawToken }); if (user) { user.security.token = hashed; await user.save(); } } return user; } /** * 取 token 命中会话的过期时间 * @returns {Date|null|undefined} null=不过期;undefined=未命中任何会话 */ function resolveTokenExpiry(user, hashedToken) { if (!user?.security) return undefined; const sessions = Array.isArray(user.security.tokens) ? user.security.tokens : []; const session = sessions.find((item) => item?.hash === hashedToken); if (session) { return session.expiry ? new Date(session.expiry) : null; } if (user.security.token === hashedToken) { return user.security.tokenExpiry ? new Date(user.security.tokenExpiry) : null; } return undefined; } /** * 认证中间件 - 验证 token 并挂载用户信息到 ctx * 可选参数: * - required: 是否必须登录(默认 true) * - appId / appIds: 允许访问的应用(任一即可),声明后必须存在有效成员关系 * - roles: 允许的角色列表(必须与 appId / appIds 一起使用) * * 角色只在该应用内判定,不再遍历用户的所有应用; * 传 appIds 是为了同时支持小程序管理端与 Web 管理端。 */ function auth(options = {}) { const { required = true, appId, appIds, roles } = options; const allowedAppIds = Array.isArray(appIds) && appIds.length ? appIds : appId ? [appId] : []; return async (ctx, next) => { const token = extractToken(ctx); if (!token) { if (!required) { ctx.state.user = null; return await next(); } return ResponseUtil.unauthorized(ctx, '缺少认证 token'); } const user = await findUserByToken(token); if (!user) { return ResponseUtil.unauthorized(ctx, '用户未登录或 token 无效'); } // 按本次 token 命中的会话判断过期,不能只看 legacy tokenExpiry: // 多端会话下其它端新登录不会影响本端 const expiry = resolveTokenExpiry(user, await hashToken(token)); if (expiry && new Date() > expiry) { return ResponseUtil.unauthorized(ctx, '登录已过期,请重新登录'); } if (user.status.account === 'lock') { return ResponseUtil.forbidden(ctx, '账户已被锁定'); } if (allowedAppIds.length > 0) { // 一次取出所有允许应用的启用成员关系:用户可能同时是多个管理端成员, // 角色判定必须逐条看,不能只取排序第一条(否则 A 应用的 user 会挡住 B 应用的 admin) const memberships = await DBModel.UserApp.find({ userId: user._id, appId: { $in: allowedAppIds }, status: 'active', }).sort({ appId: 1 }); if (!memberships.length) { return ResponseUtil.forbidden(ctx, '无权访问该应用'); } let membership = memberships[0]; if (roles && roles.length > 0) { membership = memberships.find((m) => roles.some((r) => m.roles?.includes(r))); if (!membership) { return ResponseUtil.forbidden(ctx, '权限不足'); } } ctx.state.membership = membership; ctx.state.appId = membership.appId; } else if (roles && roles.length > 0) { // 角色校验必须带应用维度,缺 appId 视为路由配置错误 return ResponseUtil.internalError(ctx, '角色校验缺少 appId'); } ctx.state.user = user; await next(); }; } /** * 返回用户安全对象(去除密码、token 等敏感字段) * 注意:登录/注册响应中的 token 由 handler 单独附加 */ function sanitizeUser(user) { const obj = user.toObject ? user.toObject() : { ...user }; delete obj.security?.passwd; delete obj.security?.passwdSalt; delete obj.security?.token; delete obj.security?.tokens; delete obj.security?.tokenExpiry; delete obj.security?.passwordResetToken; delete obj.security?.passwordResetExpiry; return obj; } export { auth, extractToken, sanitizeUser, findUserByToken };