裝置指紋

最後更新


本頁說明 Token 綁定的裝置指紋如何產生、在哪裡比對,以及偵測規則的實際行為。

產生方式


CreateFingerprint()(src/CreateFingerprint.ts)把下列四個值組成 JSON,再取 SHA-256 hex:
欄位來源
osUser-Agent 比對
browserUser-Agent 比對
deviceUser-Agent 比對
deviceIdX-Device-ID header → req.body.deviceId → "Unknown"

若 req.session.fp 存在(例如以 express-session 自行保存),所有 API 直接使用該值,不重新計算。

偵測規則


比對依表格由上而下,第一個命中即採用:
欄位順序
osWindows → Macintosh|Mac OS X → Linux → Android → iPhone|iPad|iPod → Unknown_OS
browserEdge|Edg → Firefox → Chrome → Safari → Opera|OPR → Unknown_Browser
deviceiPad → iPhone|iPod|Android.*Mobile|BlackBerry|IEMobile|Opera Mini → Desktop

因為先命中即停止,部分結果與直覺不同:
User-Agent實際結果原因
Androidos: LinuxAndroid UA 含 Linux,排在 Android 之前
iPhone/iPados: MacOSiOS UA 含 like Mac OS X
Operabrowser: ChromeOpera UA 含 Chrome

這些值只用來產生雜湊,同一裝置每次得到相同結果即可,不影響綁定效果。

比對位置


時機不符時的結果
有效 Access Token 的 fpisError: true
過期 Access Token 解碼後的 fpisError: true
Redis Refresh 資料的 fpisError: false(訪客)

相關:Token 傳遞、客戶端整合
EN