萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Node.js 客戶端 Session 實戰:無狀態架構下的身份認證與即時登出

傳統 Session 存儲於伺服器 (記憶體/Redis/資料庫),擴展時面臨同步、單點故障、黏性 Session 等難題。客戶端 Session 將加密後的 Session 資料直接存於 Cookie,實現真正的無狀態水平擴展。本文基於 client-sessions 庫,詳細講解 Express 整合、資料讀寫、安全機制與即時登出 (Persona 風格) 實現。

核心原理

  • Session 資料 → JSON 序列化 → AES-256-CBC 加密 + HMAC-SHA256 簽名 → Base64 編碼 → 存入 Cookie。
  • 密鑰僅存在伺服器,客戶端無法解密/竄改,若 Cookie 被修改,驗證失效即視為非法。
  • 優點:無需共享存儲、橫向擴展零成本、部署簡單。
  • 缺點:Cookie 大小限制 (4KB)、無法主動撤銷 (需額外機制)、敏感資料不宜存放。

Express 整合與基本用法

const express = require('express');
const clientSessions = require('client-sessions');

const app = express();

// 中介軟體配置
app.use(clientSessions({
  cookieName: 'session',        // Cookie 名稱
  secret: '0GBlJZ9EKBt2Zbi2flRPvztczCewBxXK', // 必須:強隨機長字串 (生產環境用環境變數)
  duration: 24 * 60 * 60 * 1000, // 24 小時有效期
  activeDuration: 1000 * 60 * 5, // 活躍延長 5 分鐘
  httpOnly: true,               // 防 XSS
  secure: true,                 // 僅 HTTPS (生產環境必開)
  ephemeral: false              // true = 瀏覽器關閉即失效
}));

// 登入:寫入 Session
app.post('/login', function(req, res) {
  // 驗證帳號密碼...
  req.session.userId = 12345;
  req.session.username = 'johndoe';
  req.session.role = 'admin';
  res.json({ success: true });
});

// 讀取 Session
app.get('/profile', function(req, res) {
  if (!req.session.userId) return res.status(401).send('未登入');
  res.json({ username: req.session.username, role: req.session.role });
});

// 登出:銷毀 Session
app.post('/logout', function(req, res) {
  req.session.reset(); // 刪除 Cookie
  res.json({ success: true });
});

即時登出機制:解決客戶端 Session 無法主動撤銷的痛點

問題:伺服器無法直接刪除客戶端 Cookie。用戶改密碼/被封禁/管理員強制登出時,舊 Session 仍有效直到過期。

解決方案:Session Token + 資料庫版本號

  1. 用戶表新增 sessionVersion 欄位 (預設 0)。
  2. 登入時將當前版本寫入 Session:req.session.sv = user.sessionVersion。
  3. 每請求中介軟體驗證版本一致性。
  4. 強制登出時:user.sessionVersion++ 並儲存,所有舊 Session 瞬間失效。
// 中介軟體:驗證 Session 版本
function validateSessionVersion(req, res, next) {
  if (!req.session.userId) return next(); // 未登入略過

  User.findById(req.session.userId, function(err, user) {
    if (err) return res.status(500).send('DB error');
    if (!user) {
      req.session.reset();
      return res.status(401).send('用戶不存在');
    }
    if (req.session.sv !== user.sessionVersion) {
      req.session.reset();
      return res.status(401).send('Session 已失效,請重新登入');
    }
    req.user = user; // 掛載用戶物件供下游使用
    next();
  });
}

app.use(validateSessionVersion); // 掛載在 session 中介軟體之後

// 強制登出端點 (管理員/修改密碼後調用)
app.post('/admin/force-logout/:userId', function(req, res) {
  User.findByIdAndUpdate(req.params.userId, { $inc: { sessionVersion: 1 } }, function(err) {
    if (err) return res.status(500).send('Failed');
    res.json({ success: true });
  });
});

Persona 風格即時登出 (Mozilla Persona 方案)

Persona 使用 token 欄位而非版本號:

  • 登入時生成隨機 token,寫入用戶表與 Session。
  • 每請求比對 Session token 與資料庫 token。
  • 即時登出:資料庫 token 設為 null 或重新生成。

優點:Token 可攜帶額外資訊 (裝置 ID、登入地點);缺點:每請求額外查詢 (通常合併在用戶查詢中,開銷可忽略)。

安全最佳實踐

  1. 密鑰管理:secret 必須 32+ 字元高熵值字串,存於環境變數/密鑰管理系統,定期輪換 (舊密鑰保留驗證舊 Cookie 直到自然過期)。
  2. Cookie 設定:httpOnly: true 防 XSS、secure: true 僅 HTTPS、sameSite: 'lax' 防 CSRF。
  3. 敏感資料隔離:Session 僅存 userId、sessionVersion/token、role 等授權所需最小集合;用戶資料、權限詳情每請求從資料庫/快取讀取。
  4. 防重放攻擊:短效期 (15-30 分鐘) + activeDuration 滑動延長,平衡安全與體驗。

適用場景與替代方案

場景推薦方案
無狀態微服務、Kubernetes 部署、極致水平擴展客戶端 Session (client-sessions / iron-session)
傳統單體應用、已有 Redis 集群、需 Session 列表/管理後台伺服器端 Session (express-session + connect-redis)
跨域/多子域 SSO、行動端 App、第三方整合JWT (JSON Web Token) + Refresh Token 機制
高安全性、頻繁權限變更、審計追蹤伺服器端 Session + 即時失效機制

客戶端 Session 以「以空間換時間、以計算換儲存」的巧妙設計,完美契合雲原生無狀態架構。掌握其原理與即時登出模式,是構建可擴展、可運維 Node.js 服務的關鍵技能。

copyright © 萬盛學電腦網 all rights reserved