pardnio/node-jwt-auth

最後更新

Note此 README 由 SKILL 生成,英文版請參閱 這裡。



DUAL-TOKEN JWT AUTH BOUND TO EVERY DEVICE!


npmDownloadsLicense




Node.js JWT 驗證函式庫,支援 Refresh Token 輪替、裝置指紋綁定與 Redis 撤銷黑名單

目錄



功能特點


npm install @pardnchiu/jwt-auth · 完整文件

  • 雙 Token 無感續期 — Access Token 過期時在同一個請求內以 Refresh ID 重新簽發 ES256 Token 並回寫 cookie 與 header,使用者不必重新登入。
  • 裝置指紋綁定 — Token 與 OS、瀏覽器、裝置類型及 Device ID 組成的 SHA-256 指紋綁定,被帶到其他裝置使用會直接判定為可疑請求。
  • Refresh ID 自動輪替 — 續期超過 5 次或剩餘壽命不足一半即換發新 Refresh ID,舊 ID 保留 5 秒寬限期避免併發請求失敗。
  • Redis 撤銷黑名單 — 登出時把 Access Token 寫入 Redis 黑名單,TTL 與 Token 壽命一致,過期紀錄自動清除。
  • 三態驗證結果 — 驗證結果同時回報已登入、異常請求與訪客三種狀態,路由可直接分流 401 與 400 而不必解析錯誤字串。

架構


完整架構

graph TB
    Client[客戶端] -->|Cookie / Bearer / X-Refresh-ID| App[Express 路由]
    App --> Auth[JWTAuth]
    Auth --> FP[CreateFingerprint 裝置指紋]
    Auth --> RID[CreateRefreshId]
    Auth --> JWT[jsonwebtoken ES256]
    Auth --> Redis[(Redis refresh / revoke)]
    Auth --> Check[checkUserExists 回呼]
    Auth -->|Set-Cookie / X-New-*| Client
  1. graph TB
  2. Client[客戶端] -->|Cookie / Bearer / X-Refresh-ID| App[Express 路由]
  3. App --> Auth[JWTAuth]
  4. Auth --> FP[CreateFingerprint 裝置指紋]
  5. Auth --> RID[CreateRefreshId]
  6. Auth --> JWT[jsonwebtoken ES256]
  7. Auth --> Redis[(Redis refresh / revoke)]
  8. Auth --> Check[checkUserExists 回呼]
  9. Auth -->|Set-Cookie / X-New-*| Client

授權


本專案採用 MIT LICENSE。

Author


Just open an issue to share an idea.
node-jwt-auth contributors


©️ 2025 邱敬幃 Pardn Chiu
EN