本文提到的工具
邊閱讀邊在瀏覽器中開啟工具,立即試試整個流程。

為什麼 JWT 的安全性值得仔細留意
JWT 是網頁開發中最常被錯誤實作的安全機制之一。函式庫讓您很容易讓某些東西運作起來:權杖能簽發、能驗證,一切看似正常。問題會在之後浮現:在安全稽核中、事件發生時,或是攻擊者利用某個細微的設定錯誤時。
本指南涵蓋已知的攻擊手法、透過 JWKS 派送金鑰的運作方式,以及正式環境部署的實用檢查清單。
快速回顧:JWT 是什麼
JWT(JSON Web Token)由三個以點號分隔、經 Base64Url 編碼的部分組成:
header.payload.signature
- 標頭(Header): 指定演算法(
alg)與權杖類型。 - 酬載(Payload): 包含宣告(claim),即關於主體的資料與中繼資料。
- 簽章(Signature): 證明標頭與酬載未被竄改的密碼學證據。
酬載只是被編碼,並沒有被加密。任何攔截到 JWT 的人都能讀到酬載。簽章只能證明完整性,並不提供機密性。
攻擊手法 1:alg: none 攻擊
JWT 規格最初允許演算法的值為 "none",表示權杖不帶簽章。早期的部分實作在接受這種權杖時,並未檢查是否有金鑰,讓攻擊者得以用任意酬載偽造權杖。
攻擊情境:
- 攻擊者攔截一個合法的 JWT。
- 攻擊者解碼標頭與酬載(Base64Url 解碼,不需要金鑰)。
- 攻擊者修改酬載:
"role": "admin"。 - 攻擊者以
"alg": "none"重新編碼,並送出空的簽章片段。 - 有漏洞的伺服器接受這個權杖。
防禦:
// jose 函式庫:明確的演算法允許清單
import * as jose from 'jose';
const { payload } = await jose.jwtVerify(token, secret, {
algorithms: ['HS256'], // 絕不要包含 'none'
});
絕不要依賴權杖本身所指定的演算法,來決定驗證時使用哪種演算法。演算法必須由伺服器端強制指定。
攻擊手法 2:演算法混淆(RS256 → HS256)
非對稱 JWT 以私鑰簽章、公鑰驗證。部分有漏洞的實作,會讀取 JWT 標頭中的 alg 欄位來決定驗證演算法,而這個欄位正是攻擊者可以控制的。
攻擊情境(使用公鑰的伺服器):
- 伺服器通常使用 RS256:以私鑰簽章,用戶端以公鑰驗證。
- 攻擊者知道伺服器的公鑰(畢竟它是公開的)。
- 攻擊者建立
"alg": "HS256"的 JWT。 - 攻擊者以公鑰作為密鑰,用 HMAC-SHA256 替 JWT 簽章。
- 有漏洞的伺服器從標頭讀到
alg: HS256,切換成 HMAC 驗證,並把公鑰當成 HMAC 密鑰,在不知情的情況下驗證通過了攻擊者偽造的權杖。
防禦: 在伺服器端把預期的演算法寫死。絕不要信任 alg 宣告來選擇驗證方式:
// 明確要求 RS256:忽略權杖中的 alg 宣告
import * as jose from 'jose';
const publicKey = await jose.importSPKI(publicKeyPem, 'RS256');
const { payload } = await jose.jwtVerify(token, publicKey, {
algorithms: ['RS256'],
});
攻擊手法 3:薄弱或外洩的密鑰
使用 HS256(對稱 HMAC)時,簽章與驗證用的是同一把密鑰。如果這把密鑰:
- 很短(不到 32 位元組)
- 容易預測(例如 “secret” 這個字)
- 被寫死在可公開看到的原始碼中
…攻擊者就能暴力破解或猜出來。一旦取得密鑰,就能偽造任何想要的 JWT。
防禦:
- 使用至少 256 位元(32 位元組)、密碼學安全的隨機密鑰。
- 把密鑰存放在環境變數或密鑰管理服務(AWS Secrets Manager、HashiCorp Vault)中。
- 絕不要把密鑰提交到版本控制。
# 產生高強度密鑰(Linux/Mac)
openssl rand -base64 32
# → "K8aJz3mP9xQrTvN2wY5oHiE7uLbCdF1s"
攻擊手法 4:缺少宣告驗證
簽發並驗證簽章還不夠。簽章有效,並不代表這個權杖應該被這次請求接受:
| 宣告 | 未驗證時的攻擊 |
|---|---|
exp |
過期的權杖被無限期接受 |
nbf |
權杖在預定生效時間之前就被接受 |
iss |
由其他服務簽發的權杖被接受 |
aud |
為服務 A 簽發的權杖被服務 B 接受 |
防禦:驗證所有相關宣告:
const { payload } = await jose.jwtVerify(token, secret, {
issuer: 'https://auth.example.com',
audience: 'https://api.example.com',
// exp 與 nbf 由 jose 自動驗證
});
使用 JWKS 管理金鑰
對正式環境的系統,尤其是有多個服務或第三方整合的系統,對稱的共用密鑰會變得難以管理。每個需要驗證權杖的服務都必須知道密鑰,攻擊面因此變大。
JWKS(JSON Web Key Set) 以非對稱密碼學解決這個問題:
- 授權伺服器產生一組金鑰對(私鑰與公鑰)。
- 私鑰留在授權伺服器上,用來替 JWT 簽章。
- 公鑰以標準化的 JSON 格式,發布在一個眾所周知的網址,也就是 JWKS 端點。
- 任何服務都能從 JWKS 端點取得公鑰,進而驗證 JWT。
JWT 的標頭含有 kid(Key ID)宣告,告訴驗證端要使用 JWKS 中的哪一把金鑰:
{
"alg": "RS256",
"typ": "JWT",
"kid": "2026-01-key"
}
JWKS 文件長這樣:
{
"keys": [
{
"kty": "RSA",
"use": "sig",
"alg": "RS256",
"kid": "2026-01-key",
"n": "0vx7agoebGcQSuuPiLJXZptN...",
"e": "AQAB"
}
]
}
JWKS 的優點:
- 金鑰輪替: 新增一把金鑰,等舊權杖過期後再移除舊金鑰,不需要重啟服務或派送密鑰。
- 不必共用密鑰: 服務只需要公鑰。驗證服務遭入侵,並不會危及簽章的能力。
- 支援多個簽發者: 透過檢查多個 JWKS 端點,就能驗證來自多個供應商(例如 Auth0、Okta 或您自己的服務)的權杖。
取得並快取 JWKS:
import * as jose from 'jose';
// jose 的 JWKS 用戶端會快取金鑰,遇到未知的 kid 時重新整理
const JWKS = jose.createRemoteJWKSet(
new URL('https://auth.example.com/.well-known/jwks.json')
);
const { payload } = await jose.jwtVerify(token, JWKS, {
issuer: 'https://auth.example.com',
audience: 'https://api.example.com',
});
權杖撤銷策略
JWT 是無狀態的:一旦簽發,在到期前都有效。這就帶來一個難題:如果需要立刻讓某個權杖失效(例如登出、變更密碼或帳號遭入侵之後),該怎麼辦?
策略 1:短效期限 + 更新權杖
- 存取權杖在 15~60 分鐘後過期。
- 更新權杖(以
HttpOnlyCookie 儲存)可持續 7~30 天。 - 只需要在更新權杖的層級進行撤銷。
策略 2:權杖封鎖清單
把已撤銷的 jti(JWT ID)宣告存在快速的儲存區(Redis),並設定與權杖到期時間相符的 TTL:
// 登出時
await redis.set(`blocklist:${payload.jti}`, '1', { EX: remainingSeconds });
// 每次請求時,在信任權杖之前先檢查
const isRevoked = await redis.exists(`blocklist:${payload.jti}`);
if (isRevoked) throw new Error('Token has been revoked');
策略 3:短效的簽章金鑰
每小時產生一把新的簽章金鑰,JWKS 端點只保留最近的 N 把金鑰。以已過期金鑰簽章的舊權杖會被自動拒絕。不需要封鎖清單,但需要金鑰輪替的基礎設施。
在用戶端安全地儲存
用戶端把 JWT 存在哪裡,決定了它的弱點範圍:
| 儲存方式 | XSS 風險 | CSRF 風險 | 建議 |
|---|---|---|---|
localStorage |
高 | 無 | 權杖應避免使用 |
sessionStorage |
高 | 無 | 權杖應避免使用 |
| JavaScript 變數 | 中 | 無 | 短期存在記憶體中尚可 |
HttpOnly Cookie |
無 | 有(以 SameSite 緩解) |
建議使用 |
網頁應用程式最安全的做法:把存取權杖放在記憶體中(JavaScript 變數),把更新權杖放在 HttpOnly、Secure、SameSite=Strict 的 Cookie 中。
正式環境安全檢查清單
- 簽章密鑰至少 256 位元,且是隨機產生的
- 密鑰存放在環境變數或密鑰管理服務中,而不是程式碼裡
-
alg在伺服器端明確指定,而不是讀取權杖標頭 - 絕不接受
alg: none - 設定了
exp宣告(存取權杖建議 15~60 分鐘) - 每次請求都驗證
iss與aud宣告 - 可能需要撤銷的權杖含有
jti宣告 - 所有簽發或驗證權杖的端點都強制使用 HTTPS
- 更新權杖存放在
HttpOnlyCookie,而不是localStorage - 以 JWKS 端點派送非對稱金鑰(多服務系統)
- 金鑰輪替流程已有文件並經過測試
常見問題
該用 HS256 還是 RS256?
HS256(對稱):實作簡單,適合由同一個服務簽發並驗證權杖的單一服務系統。金鑰在所有使用的地方都必須保密。
RS256(非對稱):建議用於多服務架構。私鑰只由授權伺服器持有,其他所有服務都使用公鑰(透過 JWKS)驗證。設定較複雜,但安全狀態明顯更好。
如何在不停機的情況下輪替金鑰?
在 JWKS 端點同時發布新舊兩把公鑰。以新金鑰(使用新的 kid)簽發新權杖。以舊金鑰簽章的舊權杖,仍能以 JWKS 中的舊公鑰通過驗證。等所有舊權杖都過期後,再把舊金鑰從 JWKS 移除。
JWT 可以加密嗎?
可以:JWE(JSON Web Encryption) 會加密酬載,沒有解密金鑰就讀不到內容。標準 JWT(JWS)只簽章、不加密,酬載任何人都能讀取。只有當酬載本身在傳輸過程中必須保密時,才使用 JWE。
同一個 JWT 可以同時用於驗證身分與授權嗎?
在酬載中同時放兩者是很常見的做法:sub 宣告識別使用者(驗證身分),role 或 scope 這類自訂宣告控制使用者能做什麼(授權)。請留意權杖大小,避免放入大量經常變動的授權資料。
