| 1 | 'use strict'; |
| 2 | |
| 3 | const jwt = require('jsonwebtoken'); |
| 4 | const crypto = require('crypto'); |
| 5 | const geoip = require('geoip-lite'); |
| 6 | const { getDb } = require('./db'); |
| 7 | |
| 8 | const SESSION_IDLE_TIMEOUT_MS = 60 * 60 * 1000; // 1 hour |
| 9 | |
| 10 | // Secret used to sign JWTs — generated fresh each server boot. |
| 11 | // Tokens from a previous boot are automatically invalid. |
| 12 | const JWT_SECRET = crypto.randomBytes(64).toString('hex'); |
| 13 | |
| 14 | // --------------------------------------------------------------------------- |
| 15 | // Helpers |
| 16 | // --------------------------------------------------------------------------- |
| 17 | |
| 18 | function getClientIp (req) |
| 19 | { |
| 20 | // Respect X-Forwarded-For only if you trust a reverse proxy in front. |
| 21 | // For a direct Pi deployment, req.ip is sufficient. |
| 22 | let ip = req.ip || req.connection.remoteAddress || ''; |
| 23 | // Normalize IPv4-mapped IPv6 (::ffff:127.0.0.1) and IPv6 loopback (::1) |
| 24 | // to plain IPv4 so token binding is stable across request variations. |
| 25 | ip = ip.replace(/^::ffff:/, ''); |
| 26 | if (ip === '::1') ip = '127.0.0.1'; |
| 27 | return ip; |
| 28 | } |
| 29 | |
| 30 | function getRegion (ip) |
| 31 | { |
| 32 | // ip is already normalized by getClientIp (no ::ffff: prefix, no ::1) |
| 33 | const geo = geoip.lookup(ip); |
| 34 | // Private / RFC1918 addresses won't resolve — use ip itself as region. |
| 35 | return geo ? `${geo.country}:${geo.region}` : `local:${ip}`; |
| 36 | } |
| 37 | |
| 38 | function fingerprintHash (fingerprint) |
| 39 | { |
| 40 | return crypto.createHash('sha256').update(fingerprint || '').digest('hex'); |
| 41 | } |
| 42 | |
| 43 | function nowMs () |
| 44 | { |
| 45 | return Date.now(); |
| 46 | } |
| 47 | |
| 48 | function createSession (username, req, fingerprint) |
| 49 | { |
| 50 | const db = getDb(); |
| 51 | const ip = getClientIp(req); |
| 52 | const region = getRegion(ip); |
| 53 | const fpHash = fingerprintHash(fingerprint); |
| 54 | const createdAt = nowMs(); |
| 55 | const sessionId = crypto.randomUUID(); |
| 56 | |
| 57 | db.prepare(` |
| 58 | INSERT INTO auth_sessions (session_id, username, ip, region, fp_hash, created_at, last_seen_at, revoked_at) |
| 59 | VALUES (?, ?, ?, ?, ?, ?, ?, NULL) |
| 60 | `).run([sessionId, username, ip, region, fpHash, createdAt, createdAt]); |
| 61 | |
| 62 | return { sessionId, ip, region, fpHash }; |
| 63 | } |
| 64 | |
| 65 | function revokeSession (sessionId) |
| 66 | { |
| 67 | if (!sessionId) return; |
| 68 | const db = getDb(); |
| 69 | db.prepare('UPDATE auth_sessions SET revoked_at = ? WHERE session_id = ? AND revoked_at IS NULL') |
| 70 | .run([nowMs(), sessionId]); |
| 71 | } |
| 72 | |
| 73 | // --------------------------------------------------------------------------- |
| 74 | // Token creation |
| 75 | // --------------------------------------------------------------------------- |
| 76 | |
| 77 | /** |
| 78 | * Returns a signed JWT that expires at end of the current calendar day (UTC). |
| 79 | */ |
| 80 | function createToken (username, req, fingerprint) |
| 81 | { |
| 82 | const session = createSession(username, req, fingerprint); |
| 83 | |
| 84 | const payload = { |
| 85 | u: username, |
| 86 | ip: session.ip, |
| 87 | r: session.region, |
| 88 | fp: session.fpHash, |
| 89 | sid: session.sessionId, |
| 90 | }; |
| 91 | |
| 92 | // Keep JWT short-lived; server-side idle checks are the primary control. |
| 93 | return jwt.sign(payload, JWT_SECRET, { expiresIn: '12h' }); |
| 94 | } |
| 95 | |
| 96 | // --------------------------------------------------------------------------- |
| 97 | // Middleware |
| 98 | // --------------------------------------------------------------------------- |
| 99 | |
| 100 | /** |
| 101 | * Verifies the Bearer token in the Authorization header. |
| 102 | * On success attaches `req.user = { username, isAdmin }`. |
| 103 | * On failure sends 401 with a generic "session invalid" message. |
| 104 | */ |
| 105 | function requireAuth (req, res, next) |
| 106 | { |
| 107 | const header = req.headers['authorization'] || ''; |
| 108 | const token = header.startsWith('Bearer ') ? header.slice(7) : null; |
| 109 | |
| 110 | if (!token) |
| 111 | { |
| 112 | return res.status(401).json({ error: 'Session invalid or expired.' }); |
| 113 | } |
| 114 | |
| 115 | let payload; |
| 116 | try |
| 117 | { |
| 118 | payload = jwt.verify(token, JWT_SECRET); |
| 119 | } catch |
| 120 | { |
| 121 | return res.status(401).json({ error: 'Session invalid or expired.' }); |
| 122 | } |
| 123 | |
| 124 | // Verify IP binding |
| 125 | const currentIp = getClientIp(req); |
| 126 | if (payload.ip !== currentIp) |
| 127 | { |
| 128 | // Intentionally identical error — do not reveal reason |
| 129 | return res.status(401).json({ error: 'Session invalid or expired.' }); |
| 130 | } |
| 131 | |
| 132 | // Verify region binding |
| 133 | const currentRegion = getRegion(currentIp); |
| 134 | if (payload.r !== currentRegion) |
| 135 | { |
| 136 | return res.status(401).json({ error: 'Session invalid or expired.' }); |
| 137 | } |
| 138 | |
| 139 | // Verify fingerprint (sent on every request as X-Fp header) |
| 140 | const fp = req.headers['x-fp'] || ''; |
| 141 | if (payload.fp !== fingerprintHash(fp)) |
| 142 | { |
| 143 | return res.status(401).json({ error: 'Session invalid or expired.' }); |
| 144 | } |
| 145 | |
| 146 | if (!payload.sid) |
| 147 | { |
| 148 | return res.status(401).json({ error: 'Session invalid or expired.' }); |
| 149 | } |
| 150 | |
| 151 | const db = getDb(); |
| 152 | const session = db.prepare(` |
| 153 | SELECT session_id, username, ip, region, fp_hash, last_seen_at, revoked_at |
| 154 | FROM auth_sessions |
| 155 | WHERE session_id = ? |
| 156 | `).get([payload.sid]); |
| 157 | |
| 158 | if (!session || session.revoked_at) |
| 159 | { |
| 160 | return res.status(401).json({ error: 'Session invalid or expired.' }); |
| 161 | } |
| 162 | |
| 163 | if (session.username !== payload.u || session.ip !== currentIp || session.region !== currentRegion) |
| 164 | { |
| 165 | return res.status(401).json({ error: 'Session invalid or expired.' }); |
| 166 | } |
| 167 | |
| 168 | if (session.fp_hash !== payload.fp) |
| 169 | { |
| 170 | return res.status(401).json({ error: 'Session invalid or expired.' }); |
| 171 | } |
| 172 | |
| 173 | if (nowMs() - Number(session.last_seen_at || 0) > SESSION_IDLE_TIMEOUT_MS) |
| 174 | { |
| 175 | revokeSession(payload.sid); |
| 176 | return res.status(401).json({ error: 'Session invalid or expired.' }); |
| 177 | } |
| 178 | |
| 179 | db.prepare('UPDATE auth_sessions SET last_seen_at = ? WHERE session_id = ?').run([nowMs(), payload.sid]); |
| 180 | |
| 181 | // Load user from DB |
| 182 | const user = db.prepare('SELECT id, username, is_admin, permissions FROM users WHERE username = ?') |
| 183 | .get([payload.u]); |
| 184 | |
| 185 | if (!user) |
| 186 | { |
| 187 | return res.status(401).json({ error: 'Session invalid or expired.' }); |
| 188 | } |
| 189 | |
| 190 | req.user = { |
| 191 | id: user.id, |
| 192 | username: user.username, |
| 193 | isAdmin: user.is_admin === 1, |
| 194 | permissions: JSON.parse(user.permissions || '{}'), |
| 195 | }; |
| 196 | req.authSessionId = payload.sid; |
| 197 | |
| 198 | next(); |
| 199 | } |
| 200 | |
| 201 | /** |
| 202 | * Middleware that additionally requires admin privileges. |
| 203 | */ |
| 204 | function requireAdmin (req, res, next) |
| 205 | { |
| 206 | if (!req.user || !req.user.isAdmin) |
| 207 | { |
| 208 | return res.status(403).json({ error: 'Admin access required.' }); |
| 209 | } |
| 210 | next(); |
| 211 | } |
| 212 | |
| 213 | module.exports = { |
| 214 | createToken, |
| 215 | requireAuth, |
| 216 | requireAdmin, |
| 217 | getClientIp, |
| 218 | getRegion, |
| 219 | revokeSession, |
| 220 | SESSION_IDLE_TIMEOUT_MS, |
| 221 | }; |