280 lines
14 KiB
JavaScript
280 lines
14 KiB
JavaScript
// 多用户会话认证:用户名/明文密码配在 config.yml 的 auth.users,登录后签发 HMAC 签名 token,
|
||
// 以 HttpOnly cookie 下发(SameSite=Lax,浏览器在 XHR 与原生下载导航中都会自动携带)。
|
||
// 替代原先 nginx htpasswd 的 basic auth:手机浏览器原生下载不带 Basic 认证头,导致下载失败。
|
||
const express = require('express');
|
||
const crypto = require('crypto');
|
||
const path = require('path');
|
||
const { readConfigText, applyEditsToText, loadConfigFromText, writeConfigText } = require('./config');
|
||
const log = require('./log');
|
||
|
||
const COOKIE_NAME = 'agent_token';
|
||
const DEFAULT_TTL_MS = 30 * 24 * 3600 * 1000; // 30 天
|
||
|
||
function b64url(buf) {
|
||
return Buffer.from(buf).toString('base64url').replace(/=+$/, '');
|
||
}
|
||
function timingEqual(a, b) {
|
||
// 先哈希再定长比较:timingSafeEqual 要求等长 buffer,哈希后既定长又避免长度旁路
|
||
const ha = crypto.createHash('sha256').update(String(a)).digest();
|
||
const hb = crypto.createHash('sha256').update(String(b)).digest();
|
||
return crypto.timingSafeEqual(ha, hb);
|
||
}
|
||
|
||
// ---------- token:payloadB64url.signature(无状态,密钥变更/重启即失效) ----------
|
||
function signToken(username, expires, secret) {
|
||
const payload = b64url(Buffer.from(JSON.stringify({ u: username, exp: expires }), 'utf8'));
|
||
const sig = crypto.createHmac('sha256', secret).update(payload).digest('hex');
|
||
return payload + '.' + sig;
|
||
}
|
||
|
||
function readToken(token, secret) {
|
||
if (!token || typeof token !== 'string') return null;
|
||
const i = token.lastIndexOf('.');
|
||
if (i <= 0) return null;
|
||
const payload = token.slice(0, i);
|
||
const sig = token.slice(i + 1);
|
||
const expected = crypto.createHmac('sha256', secret).update(payload).digest('hex');
|
||
if (!timingEqual(sig, expected)) return null;
|
||
try {
|
||
const data = JSON.parse(Buffer.from(payload, 'base64url').toString('utf8'));
|
||
if (!data || typeof data.u !== 'string' || !Number.isFinite(data.exp) || data.exp < Date.now()) return null;
|
||
return { user: data.u };
|
||
} catch (_) { return null; }
|
||
}
|
||
|
||
// ---------- cookie / basic 凭据解析 ----------
|
||
function parseCookies(req) {
|
||
const out = {};
|
||
const raw = req.headers.cookie;
|
||
if (!raw) return out;
|
||
for (const part of raw.split(';')) {
|
||
const i = part.indexOf('=');
|
||
if (i > 0) out[part.slice(0, i).trim()] = decodeURIComponent(part.slice(i + 1).trim());
|
||
}
|
||
return out;
|
||
}
|
||
|
||
// Authorization: Basic 兼容层(curl / API 脚本用;浏览器页面下载走 cookie)
|
||
function basicAuthUser(req, users) {
|
||
const h = req.headers.authorization;
|
||
if (!h || !h.startsWith('Basic ')) return null;
|
||
let decoded;
|
||
try { decoded = Buffer.from(h.slice(6), 'base64').toString('utf8'); } catch (_) { return null; }
|
||
const i = decoded.indexOf(':');
|
||
if (i < 0) return null;
|
||
const name = decoded.slice(0, i);
|
||
const pass = decoded.slice(i + 1);
|
||
for (const u of users) {
|
||
if (timingEqual(u.user, name) && timingEqual(u.password, pass)) return u.user;
|
||
}
|
||
return null;
|
||
}
|
||
|
||
// ---------- 免认证路径(登录页自身需要的资源) ----------
|
||
const PUBLIC_EXACT = new Set(['/login', '/logout', '/api/login', '/api/logout', '/api/login_restore', '/api/health']);
|
||
function isPublicPath(p) {
|
||
// 尾斜杠容忍:客户端手动填服务器地址常多带一个 `/`(拼成 `/api/health/`),
|
||
// Express 路由本身能匹配,但这里若不规范化,中间件会先回 401——地址明明是对的却报未登录。
|
||
const norm = p.length > 1 ? p.replace(/\/+$/, '') : p;
|
||
if (PUBLIC_EXACT.has(norm)) return true;
|
||
if (p.startsWith('/css/')) return true; // 登录页复用 style.css
|
||
if (p === '/favicon.ico') return true;
|
||
return false;
|
||
}
|
||
|
||
// 登录成功后的回跳目标:只允许本站绝对路径,拦掉 //evil.com(协议相对)与反斜杠混淆,防开放重定向。
|
||
function safeNextUrl(u) {
|
||
const s = String(u || '');
|
||
if (!s.startsWith('/') || s.startsWith('//') || s.includes('\\')) return '/';
|
||
return s;
|
||
}
|
||
|
||
// 带签名 token 的临时下载链接(files.js 自己验签),此处放行由路由层拒绝伪造请求。
|
||
// URL 形态都要认:/files/download?path=…、/files/download-name/<名字>?path=…,
|
||
// 及打包下载 /files/zip?paths=…、/files/zip-name/<名字>?paths=…;
|
||
// 只认旧形态会让 APK 系统下载器(不带 cookie、依赖 token)对新链接拿 401。
|
||
function isSignedDownload(req) {
|
||
return req.method === 'GET' && /\/files\/(download(-name\/.+)?|zip(-name\/.+)?)$/.test(req.path) && !!req.query.t;
|
||
}
|
||
|
||
// cfg.auth = { users: [{user, password, role?, model?}], secret?, ttl_ms? }
|
||
// users 为空则整个认证关闭(cfg.auth 为 null)。
|
||
function createAuth(cfg) {
|
||
const router = express.Router();
|
||
let users = (cfg.auth && cfg.auth.users) || [];
|
||
if (!users.length) {
|
||
// 未启用认证 = 单用户自用:管理接口按「本机主人」放行,用户 CRUD 由 routes/users.js 自己拒绝。
|
||
// /api/me 在关闭分支里也必须存在:前端靠它一次请求判定形态(auth:false = 未启用),
|
||
// 若这里不注册,本地模式(无认证)下浏览器网络面板会永远挂着一条红色 404,
|
||
// 也无法区分「路由不存在」和「cookie 失效」——后者才该跳登录页。
|
||
router.get('/api/me', (req, res) => {
|
||
res.json({ user: null, role: 'admin', model: '', auth: false });
|
||
});
|
||
return {
|
||
enabled: false,
|
||
middleware: (req, res, next) => next(),
|
||
router,
|
||
requireAdmin: (req, res, next) => next(),
|
||
refreshUsers: () => {},
|
||
isAdmin: () => false,
|
||
};
|
||
}
|
||
|
||
const secret = (cfg.auth.secret && String(cfg.auth.secret)) || crypto.randomBytes(32).toString('hex');
|
||
if (!cfg.auth.secret) {
|
||
log.warn('auth', '未配置 auth.secret,已使用随机密钥:进程重启后所有登录态失效');
|
||
}
|
||
const ttlMs = Number(cfg.auth.ttl_ms) || DEFAULT_TTL_MS;
|
||
let validUsers = new Map(users.map(u => [String(u.user), String(u.password)]));
|
||
|
||
function userRow(name) {
|
||
const n = String(name == null ? '' : name);
|
||
return users.find(u => String(u.user) === n) || null;
|
||
}
|
||
function isAdmin(name) {
|
||
const u = userRow(name);
|
||
return !!u && u.role === 'admin';
|
||
}
|
||
// 用户增删改后由 routes/users.js 调用:重建登录校验表(删除的用户旧 token 随即失效)。
|
||
function refreshUsers(next) {
|
||
users = Array.isArray(next) ? next : [];
|
||
validUsers = new Map(users.map(u => [String(u.user), String(u.password)]));
|
||
}
|
||
|
||
function setAuthCookie(res, username) {
|
||
const token = signToken(username, Date.now() + ttlMs, secret);
|
||
res.setHeader('Set-Cookie', COOKIE_NAME + '=' + encodeURIComponent(token)
|
||
+ '; Path=/; HttpOnly; SameSite=Lax; Max-Age=' + Math.floor(ttlMs / 1000));
|
||
return token;
|
||
}
|
||
function clearAuthCookie(res) {
|
||
res.setHeader('Set-Cookie', COOKIE_NAME + '=; Path=/; HttpOnly; SameSite=Lax; Max-Age=0');
|
||
}
|
||
function sessionUser(req) {
|
||
const token = parseCookies(req)[COOKIE_NAME];
|
||
const data = readToken(token, secret);
|
||
// 用户可能已从配置中删除:token 有效但用户不存在也视为未登录
|
||
if (data && validUsers.has(data.user)) return data.user;
|
||
return null;
|
||
}
|
||
|
||
// 统一身份解析:cookie 优先于 Authorization: Basic。
|
||
// cookie 是浏览器全局的(切号登录立即覆盖、SSE 导航下载都带它),而 Basic 头可能来自
|
||
// 旧标签页残留的 sessionStorage 凭据——两者取用时若 Basic 优先,会出现 /api/me(读 cookie)
|
||
// 与业务路由(读 Basic)身份分裂。统一 cookie 优先保证同一浏览器内所有请求认定同一用户,
|
||
// Basic 仅作为无 cookie 场景(curl / API 脚本)的兜底。
|
||
function authUser(req) {
|
||
return sessionUser(req) || basicAuthUser(req, users);
|
||
}
|
||
|
||
// ----- 登录/登出 API -----
|
||
router.post('/api/login', (req, res) => {
|
||
const { user, password } = req.body || {};
|
||
const expect = validUsers.get(String(user || ''));
|
||
if (expect == null || !timingEqual(expect, String(password == null ? '' : password))) {
|
||
log.warn('auth', '登录失败(用户名或密码错误):user=' + String(user || '-') + ' ip=' + (req.ip || '-'));
|
||
return res.status(401).json({ error: '用户名或密码错误' });
|
||
}
|
||
setAuthCookie(res, String(user));
|
||
// 用户进入系统的唯一关口:记一条 info,便于对照后续该用户的会话/消息日志
|
||
log.info('auth', '用户 ' + String(user) + ' 登录 ip=' + (req.ip || '-'));
|
||
// token 一并回给前端:WebView 封装 APK 杀进程后 cookie 可能没落盘,
|
||
// 前端存 localStorage,下次进登录页用 /api/login_restore 自动恢复。
|
||
res.json({ ok: true, user: String(user), token: signToken(String(user), Date.now() + ttlMs, secret) });
|
||
});
|
||
|
||
// 自动恢复登录态(主要是 WebView 封装场景):cookie 丢了但 localStorage 里的 token 还在,
|
||
// 携 Authorization: Bearer <token> 请求本接口,验签通过则重新下发 cookie。
|
||
router.post('/api/login_restore', (req, res) => {
|
||
const h = String(req.headers.authorization || '');
|
||
const data = readToken(h.startsWith('Bearer ') ? h.slice(7).trim() : '', secret);
|
||
if (!data || !validUsers.has(data.user)) return res.status(401).json({ error: '登录态已失效,请重新登录' });
|
||
setAuthCookie(res, data.user); // 重新签发,顺带续期
|
||
// APK 冷启动常触发,属自动恢复而非手动登录,记 debug 避免刷屏
|
||
log.debug('auth', '用户 ' + data.user + ' 恢复登录态(login_restore)');
|
||
res.json({ ok: true, user: data.user });
|
||
});
|
||
|
||
router.post('/api/logout', (req, res) => {
|
||
clearAuthCookie(res);
|
||
res.json({ ok: true });
|
||
});
|
||
|
||
// ----- 修改密码(设置页) -----
|
||
// 已登录即可改自己的密码(免输原密码) → 写回 config.yml(保留注释,校验失败不动文件)
|
||
// → 同步更新内存(users/validUsers),立即生效无需重启。
|
||
// 已签发的 token 不失效(HMAC 无状态);其他设备下次登录才需新密码。
|
||
// 注:本路由挂在认证中间件之前,需手动验登录态。
|
||
router.post('/api/password', (req, res) => {
|
||
try {
|
||
const me = sessionUser(req);
|
||
if (!me) return res.status(401).json({ error: '未登录' });
|
||
const newP = String((req.body && req.body.new_password == null ? '' : req.body.new_password));
|
||
if (newP.length < 6) return res.status(400).json({ error: '新密码至少 6 位' });
|
||
const idx = users.findIndex(u => String(u.user) === me);
|
||
if (idx < 0) return res.status(404).json({ error: '当前用户已不在配置中' });
|
||
if (newP === users[idx].password) return res.status(400).json({ error: '新密码与当前密码相同' });
|
||
const text = readConfigText(cfg);
|
||
if (text === null) return res.status(409).json({ error: '配置文件不存在,无法持久化新密码' });
|
||
let nextText;
|
||
try {
|
||
nextText = applyEditsToText(text, [{ path: ['auth', 'users', String(idx), 'password'], value: newP }]);
|
||
loadConfigFromText(nextText, cfg.config_path);
|
||
} catch (e) {
|
||
return res.status(400).json({ error: '写入配置失败:' + String(e && e.message || e) });
|
||
}
|
||
writeConfigText(cfg, nextText);
|
||
// 内存同步:users 与 engine.cfg 是同一对象,Basic 认证实时生效;cookie 登录查 validUsers
|
||
users[idx].password = newP;
|
||
validUsers.set(me, newP);
|
||
log.info('auth', '用户 ' + me + ' 修改了密码');
|
||
res.json({ ok: true });
|
||
} catch (e) {
|
||
res.status(500).json({ error: String(e && e.message || e) });
|
||
}
|
||
});
|
||
|
||
router.get('/api/me', (req, res) => {
|
||
// 与中间件同一解析顺序(cookie 优先),保证 /api/me 显示的用户与业务路由认定的用户一致
|
||
const name = authUser(req);
|
||
const row = name ? userRow(name) : null;
|
||
// auth:true 让前端明确区分「启用了认证但当前无登录」(user:null → 跳登录)
|
||
// 与「根本没启用认证」(auth:false → 单用户自用)这两种 user:null。
|
||
res.json({ user: name, role: row ? row.role : '', model: row ? (row.model || '') : '', auth: true });
|
||
});
|
||
|
||
// ----- 登录页 / 登出跳转 -----
|
||
router.get('/login', (req, res) => {
|
||
// 已登录直接放行:优先回跳 next 指定的原页面(中间件在 302 来 /login 时带上的)
|
||
if (sessionUser(req)) return res.redirect(safeNextUrl(req.query.next));
|
||
res.sendFile(path.join(__dirname, 'public', 'login.html'));
|
||
});
|
||
|
||
router.get('/logout', (req, res) => {
|
||
clearAuthCookie(res);
|
||
// 带标记:登录页据此清掉 localStorage 里的恢复 token,避免自动登录把用户“投回去”
|
||
res.redirect('/login?logged_out=1');
|
||
});
|
||
|
||
// ----- 全局认证中间件:cookie 或 Basic 任一通过;否则 API 回 401、页面跳登录页 -----
|
||
const middleware = (req, res, next) => {
|
||
const user = authUser(req);
|
||
if (user) { req.user = user; return next(); }
|
||
if (isPublicPath(req.path) || isSignedDownload(req)) return next();
|
||
if (req.path.startsWith('/api/')) return res.status(401).json({ error: '未登录' });
|
||
// 带上原始 URL(含 query),登录页成功后回跳,不再一律进首页
|
||
return res.redirect('/login?next=' + encodeURIComponent(req.originalUrl));
|
||
};
|
||
|
||
// 管理接口门禁(挂在 auth.middleware 之后):仅 admin 可进。
|
||
function requireAdmin(req, res, next) {
|
||
if (!req.user) return res.status(401).json({ error: '未登录' });
|
||
if (!isAdmin(req.user)) return res.status(403).json({ error: '需要管理员权限' });
|
||
next();
|
||
}
|
||
|
||
return { enabled: true, middleware, router, requireAdmin, refreshUsers, isAdmin };
|
||
}
|
||
|
||
module.exports = { createAuth, COOKIE_NAME };
|