Files
api_user/middleware/auth.js
T

157 lines
5.1 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.
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 };