JWT 與安全權杖指南圖片

為什麼 JWT 的安全性值得仔細留意

JWT 是網頁開發中最常被錯誤實作的安全機制之一。函式庫讓您很容易讓某些東西運作起來:權杖能簽發、能驗證,一切看似正常。問題會在之後浮現:在安全稽核中、事件發生時,或是攻擊者利用某個細微的設定錯誤時。

本指南涵蓋已知的攻擊手法、透過 JWKS 派送金鑰的運作方式,以及正式環境部署的實用檢查清單。


快速回顧:JWT 是什麼

JWT(JSON Web Token)由三個以點號分隔、經 Base64Url 編碼的部分組成:

header.payload.signature
  • 標頭(Header): 指定演算法(alg)與權杖類型。
  • 酬載(Payload): 包含宣告(claim),即關於主體的資料與中繼資料。
  • 簽章(Signature): 證明標頭與酬載未被竄改的密碼學證據。

酬載只是被編碼,並沒有被加密。任何攔截到 JWT 的人都能讀到酬載。簽章只能證明完整性,並不提供機密性。


攻擊手法 1:alg: none 攻擊

JWT 規格最初允許演算法的值為 "none",表示權杖不帶簽章。早期的部分實作在接受這種權杖時,並未檢查是否有金鑰,讓攻擊者得以用任意酬載偽造權杖。

攻擊情境:

  1. 攻擊者攔截一個合法的 JWT。
  2. 攻擊者解碼標頭與酬載(Base64Url 解碼,不需要金鑰)。
  3. 攻擊者修改酬載:"role": "admin"。
  4. 攻擊者以 "alg": "none" 重新編碼,並送出空的簽章片段。
  5. 有漏洞的伺服器接受這個權杖。

防禦:

// jose 函式庫:明確的演算法允許清單
import * as jose from 'jose';

const { payload } = await jose.jwtVerify(token, secret, {
  algorithms: ['HS256'],  // 絕不要包含 'none'
});

絕不要依賴權杖本身所指定的演算法,來決定驗證時使用哪種演算法。演算法必須由伺服器端強制指定。


攻擊手法 2:演算法混淆(RS256 → HS256)

非對稱 JWT 以私鑰簽章、公鑰驗證。部分有漏洞的實作,會讀取 JWT 標頭中的 alg 欄位來決定驗證演算法,而這個欄位正是攻擊者可以控制的。

攻擊情境(使用公鑰的伺服器):

  1. 伺服器通常使用 RS256:以私鑰簽章,用戶端以公鑰驗證。
  2. 攻擊者知道伺服器的公鑰(畢竟它是公開的)。
  3. 攻擊者建立 "alg": "HS256" 的 JWT。
  4. 攻擊者以公鑰作為密鑰,用 HMAC-SHA256 替 JWT 簽章。
  5. 有漏洞的伺服器從標頭讀到 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) 以非對稱密碼學解決這個問題:

  1. 授權伺服器產生一組金鑰對(私鑰與公鑰)。
  2. 私鑰留在授權伺服器上,用來替 JWT 簽章。
  3. 公鑰以標準化的 JSON 格式,發布在一個眾所周知的網址,也就是 JWKS 端點。
  4. 任何服務都能從 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 分鐘後過期。
  • 更新權杖(以 HttpOnly Cookie 儲存)可持續 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
  • 更新權杖存放在 HttpOnly Cookie,而不是 localStorage
  • 以 JWKS 端點派送非對稱金鑰(多服務系統)
  • 金鑰輪替流程已有文件並經過測試

常見問題

該用 HS256 還是 RS256?

HS256(對稱):實作簡單,適合由同一個服務簽發並驗證權杖的單一服務系統。金鑰在所有使用的地方都必須保密。

RS256(非對稱):建議用於多服務架構。私鑰只由授權伺服器持有,其他所有服務都使用公鑰(透過 JWKS)驗證。設定較複雜,但安全狀態明顯更好。

如何在不停機的情況下輪替金鑰?

在 JWKS 端點同時發布新舊兩把公鑰。以新金鑰(使用新的 kid)簽發新權杖。以舊金鑰簽章的舊權杖,仍能以 JWKS 中的舊公鑰通過驗證。等所有舊權杖都過期後,再把舊金鑰從 JWKS 移除。

JWT 可以加密嗎?

可以:JWE(JSON Web Encryption) 會加密酬載,沒有解密金鑰就讀不到內容。標準 JWT(JWS)只簽章、不加密,酬載任何人都能讀取。只有當酬載本身在傳輸過程中必須保密時,才使用 JWE。

同一個 JWT 可以同時用於驗證身分與授權嗎?

在酬載中同時放兩者是很常見的做法:sub 宣告識別使用者(驗證身分),role 或 scope 這類自訂宣告控制使用者能做什麼(授權)。請留意權杖大小,避免放入大量經常變動的授權資料。