KeyFrame

Most Devs Get API Authentication Wrong ?

CsMadeEz·4月21日週二·14 min中文

三句話摘要

系統性比較 Basic Auth、Bearer Token 與 JWT 三種 API 認證方式的原理、優缺點與適用場景。 認證方案沒有最好只有最適合:內部工具用 Basic Auth、公開 API 用 JWT 搭配 Refresh Token 模式、單機 Web App 用 Opaque Token,匹配真實需求而非追求最新趨勢,才是工程師該做的判斷。 HTTP 無狀態是認證問題的根源。 每個 HTTP 請求彼此獨立,伺服器沒有記憶,因此每次請求都必須攜帶身份證明,而不同的認證方案本質上是在解決「怎麼每次都証明自己是誰」這個問題。

重點整理

重點
  • 1

    HTTP 無狀態是認證問題的根源。 每個 HTTP 請求彼此獨立,伺服器沒有記憶,因此每次請求都必須攜帶身份證明,而不同的認證方案本質上是在解決「怎麼每次都証明自己是誰」這個問題。

  • 2

    Basic Auth 的安全性完全依賴 HTTPS。 Base64 是編碼而非加密,任何人都能解碼;有了 HTTPS 整條連線加密,Base64 內容才不會被截取。它夠簡單、適合 CI/CD 或內部服務,但每次請求都帶帳密,暴露面積大,不適合公開 API。

  • 3

    JWT 以數學驗簽取代資料庫查詢,但代價是無法即時撤銷。 JWT 的 Signature 由 Header + Payload 加密簽出,任何篡改都會讓驗證失敗;服務器只需運算就能驗證,不用連資料庫,天然橫向擴展。但 token 一旦發出就活在客戶端,即使帳號被盜也要等到過期才失效。

  • 4

    Refresh Token 模式是實務上的最佳平衡。 發兩個 token:短效 JWT(15 分鐘)用於每次 API 請求,長效 Opaque Token(7 天)存在資料庫,只用來換新的 JWT。兩者組合兼顧速度與可撤銷性。

實用技巧與重點

乾貨
  • 具體數字與時間:
  • Access Token 建議存活時間:15 分鐘
  • Refresh Token 建議存活時間:7 天
  • JWT 過期越短,被盜後的風險窗口越小
  • 工具 / 函式庫名稱:
  • Node.js:`jsonwebtoken`
  • Python:`PyJWT`
  • Java:`java-jwt`
  • 快取方案:Redis(用於共享 Opaque Token 狀態)
  • JWT 三段結構:
  • Header:`alg`(演算法)+ `typ`(類型 = JWT)
  • Payload:`sub`(Subject/用戶ID)、`iat`(IssuedAt)、`exp`(Expiration)+自定義欄位(Role、Permissions)
  • Signature:Base64(Header) + "." + Base64(Payload) 用密鑰加密後的結果
  • 簽名演算法:
  • 對稱式:HMAC-SHA256(同一把 secret 簽發與驗證,適合單一伺服器)
  • 非對稱式:RS256(private key 簽發,public key 驗證,適合微服務)
  • 5 條不可談判安全原則:
  • 永遠用 HTTPS,無例外
  • Token 存 HTTPOnly Cookie,而非 localStorage;加 `SameSite=Strict` 防 CSRF
  • Access Token 短效(15 分鐘),縮小被盜風險窗口
  • 使用經過大量審計的成熟函式庫,不要自己實作加密
  • 驗證 JWT 時必須白名單指定允許的演算法(防止 `alg: none` 攻擊)
  • 選型速查:
  • | 場景 | 方案 |
  • |------|------|
  • | 內部工具、CI/CD | Basic Auth over HTTPS |
  • | 公開 API、多伺服器 | JWT(Stateless,橫向擴展) |
  • | 單台伺服器的 Web App | Opaque Bearer Token + Session |

結論

結論

認證方案沒有最好只有最適合:內部工具用 Basic Auth、公開 API 用 JWT 搭配 Refresh Token 模式、單機 Web App 用 Opaque Token,匹配真實需求而非追求最新趨勢,才是工程師該做的判斷。

完整解析

詳細

Web API 認證的本質問題源自 HTTP 的無狀態性。HTTP 協議中每一個請求都是獨立事件,伺服器沒有任何記憶,這意味著用戶在第一個請求中驗證了身份,到了第二個請求(哪怕只隔半秒)伺服器一樣不認識你。認證(Authentication)要解決的是「你是誰」的問題,而授權(Authorization)是在「你已確認身份」之後才問「你能做什麼」。這兩件事順序固定,不可顛倒,而本影片聚焦在前者:如何在 HTTP 無狀態的前提下,每次請求都能可靠地証明身份。

最早的解法是 Basic Auth:將 username 與 password 用冒號拼接,再以 Base64 編碼後放進每個請求的 HTTP Header。重要的是,Base64 是「編碼」不是「加密」,任何人拿到字串都能秒解碼。因此 Basic Auth 的安全性完全依賴 HTTPS——HTTPS 將整條連線加密,外人根本碰不到那個可被解碼的字串。這個方案夠簡單、部署快、適合 CI/CD pipeline 或只有少數信任方使用的內部服務;但它的致命缺點是每次請求都帶上帳密,每次都是一次可能出錯的機會,因此公開 API 不適合使用。

Opaque Bearer Token 改善了這一點:用戶只在登入時傳一次帳密,伺服器驗證後回傳一個隨機字串(token),後續所有請求只帶這個 token 即可。概念上就像音樂節的手環——入場驗票一次,之後憑手環進出,不用每次再拿票。然而 Opaque Token 本身沒有任何語意,只是一串隨機字元,伺服器收到後必須去資料庫查詢「這個 token 屬於誰、有什麼權限」。單機架構下這沒問題,但當服務水平擴展成多個節點時,所有節點都需要共享同一個 token 資料庫或 Redis Cache,架構複雜度隨節點數線性增長。

JWT(JSON Web Token)正是為了解決這個擴展問題而生。JWT 由三段組成:Header(聲明演算法與 token 類型)、Payload(攜帶用戶 ID、角色、過期時間等聲明)、Signature(對前兩段做加密簽名)。伺服器收到 JWT 後只需用密鑰做數學運算驗證簽名,無需查詢任何資料庫。一旦簽名驗証通過,Payload 中的所有信息即可直接信任使用。這使得任何持有相同 secret(或 public key)的服務器都能獨立驗證 token,天然支持橫向擴展。但 JWT 有個根本限制:token 不存在伺服器端,一旦發出就活在客戶端,即使帳號被盜也無法即時撤銷,只能等到 token 自然過期。這也是為何 JWT 的過期時間必須短,建議 15 分鐘。

短效 token 帶來新問題:用戶豈不是要每 15 分鐘登入一次?解法是 Refresh Token 模式:同時發出兩個 token,短效 JWT(15 分鐘)用於每次 API 請求,長效 Opaque Refresh Token(7 天)存在資料庫,只在 Access Token 過期時用來靜默換新 JWT。這樣用戶無感,但長效 token 因為存在資料庫,隨時可以撤銷。在演算法選擇上,單一伺服器使用對稱式 HMAC-SHA256 即可;微服務架構則應採用非對稱式 RS256,Auth Server 持有 private key 簽發 token,其餘服務只需 public key 驗證,private key 永不外流。最後,安全上還需防範 `alg: none` 攻擊——攻擊者將 Header 中的演算法改為 `none`,讓伺服器跳過驗証;防禦方法是在驗証邏輯中明確白名單指定可接受的演算法(如只允許 RS256),一行設定即可徹底封堵。

關鍵時刻

Pipeline v2

帶時間戳的重點,會在逐字稿層級分析上線後產生。目前請先透過原始影片觀看。

事實查核

Pipeline v2

說法查證是下一次管線升級的一部分。KeyFrame 只會顯示它真正能驗證的內容。

更多「Web2 安全」的內容

Apple Can’t Fix This Security Exploit…
編輯精選
7 min
Web2 安全英文6月20日

Apple Can’t Fix This Security Exploit…

TechLinked

  • Apple 舊款 iPhone 存在不可修補的硬體漏洞:由 Paradigm Shift 研究團隊發現,漏洞位於 USB 控制器層,可在 iOS 啟動前就取得設備控制權。由於需要實體接觸與有線連接,一般使用者日常風險較低,但手機被竊後就可能成為攻入者的入口。
  • META 積極推動聯邦立法以對抗州級訴訟:面對全美超過千件涉及平台縱容犯罪的民事案件,META 選擇透過遊說要求聯邦政府介入、統一管轄,以取代各州分散的訴訟壓力。這是防禦性法律策略,而非從根本解決平台安全問題。
  • Waymo 自駕安全問題持續累積:近 4,000 起事故紀錄中包含闖入施工封閉區、駛入水中等嚴重情境,已觸發多次 NHTSA 正式調查與召回。這顯示自駕技術在非結構化環境下仍有系統性弱點。
Eksploitasi LPE Terbaru 2026: Dirty Frag | CVE-2026-43284 & CVE-2026-43500 | Rooting Linux
10 min
Web2 安全英文6月20日

Eksploitasi LPE Terbaru 2026: Dirty Frag | CVE-2026-43284 & CVE-2026-43500 | Rooting Linux

Naughtysec

  • DirtyFrag 機制類似 DirtyPipe,但因無 Race Condition 而不會造成 Kernel 崩潰或觸發 Buffer Overflow,舊版類似漏洞(如 Buckeye 時期)因有競爭條件會導致伺服器變得如 DoS 狀態,DirtyFrag 解決了這個不穩定問題。
  • 目標防火牆封鎖了標準 Reverse Shell(PentestMonkey 的 bash/nc 類型),因此必須改用 Chisel 建立 TCP Tunnel,再透過 gsocket 穿透防火牆,而非直接連線。
  • gsocket 的 session 具備高度持久性,即使伺服器重啟後連線仍可維持,講者提到曾有 session 存活超過一年,使其成為理想的隱蔽隧道工具。
Hack The Box Administrator | Full Walkthrough
編輯精選
23 min
Web2 安全英文6月20日

Hack The Box Administrator | Full Walkthrough

Cole Mahoney Cybersecurity

  • BloodHound 的「Outbound Object Control」是核心突破口:每換一個使用者就立刻回到 BloodHound 查看該帳號對外的 AD 物件控制權,這條鏈式思維決定整個攻擊路線,是橫向移動的核心依據。
  • 強制改密碼(ForceChangePassword)是 GenericAll 最快的利用方式:對 Michael、Benjamin 等帳號都直接用 `net rpc password` 改密,比注入 ACE 或其他手法更直接,適合在已控帳號有 GenericAll 的場景快速推進。
  • Password Safe 資料庫是隱藏的憑證倉庫:Benjamin 因隸屬 Share Moderators 群組能存取 FTP,其中藏有 `backup.psafe3` 加密資料庫;用 `pwsafe2john` 提取 hash、John 破解 master password 後,即可取出 Emily 的明文密碼。