// 多用户会话认证:用户名/明文密码配在 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 请求本接口,验签通过则重新下发 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 };