萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

啟用 HTTP Public Key Pinning (HPKP) 保護 HTTPS 網站:Apache/Nginx/Lighttpd 設定指南

HTTP Public Key Pinning (HPKP) 透過 Public-Key-Pins 回應標頭,強制瀏覽器只接受特定公開金鑰簽發的憑證,防範偽造 CA 簽發惡意憑證。本文解析 SPKI 指紋原理、備份金鑰策略、三大主流 Web 伺服器設定範例與 Chrome 已知 Bug。

HPKP 運作原理

  • 標頭僅於 HTTPS 連線傳送。
  • max-age:快取秒數(例 2592000 = 30 天)。
  • includeSubDomains:延伸至子網域。
  • pin-sha256="base64(SPKI指紋)":至少兩組(一主一備)。
  • report-uri:違規回報端點。

為何針對 SPKI 而非憑證雜湊?

CA 可重新簽發同金鑰不同有效期的憑證,若釘選憑證雜湊會導致更新失敗。SPKI(SubjectPublicKeyInfo)包含演算法、參數與公開金鑰,金鑰不變即通過驗證。

釘選策略建議

  1. 最簡單:釘選第一中繼 CA(如 COMODO RSA DV CA),同 CA 續簽無影響。
  2. 較安全:準備兩組備份金鑰(離線保存),向不同 CA 簽發,共三組 SPKI 指紋全釘選。
  3. RFC 規定:至少兩組 pin,一主一備。

產生 SPKI 指紋 (Base64 SHA-256)

openssl x509 -noout -in certificate.pem -pubkey |
openssl asn1parse -noout -inform pem -out public.key
openssl dgst -sha256 -binary public.key | openssl enc -base64
# 輸出範例:klO23nT2ehFDXCfx3eHTDRESMz3asj1muO+4aIdjiuY=

Web 伺服器設定範例 (30 天、含子網域)

Apache (需 mod_headers)

LoadModule headers_module modules/mod_headers.so
Header set Public-Key-Pins "pin-sha256=\"klO23nT2ehFDXCfx3eHTDRESMz3asj1muO+4aIdjiuY=\"; pin-sha256=\"633lt352PKRXbOwf4xSEa1M517scpD3l5f79xMD9r9Q=\"; max-age=2592000; includeSubDomains"

Nginx

add_header Public-Key-Pins 'pin-sha256="klO23nT2ehFDXCfx3eHTDRESMz3asj1muO+4aIdjiuY="; pin-sha256="633lt352PKRXbOwf4xSEa1M517scpD3l5f79xMD9r9Q="; max-age=2592000; includeSubDomains';

Lighttpd

server.modules += ( "mod_setenv" )
$HTTP["scheme"] == "https" {
  setenv.add-response-header = ( "Public-Key-Pins" => "pin-sha256=\"klO23nT2ehFDXCfx3eHTDRESMz3asj1muO+4aIdjiuY=\"; pin-sha256=\"633lt352PKRXbOwf4xSEa1M517scpD3l5f79xMD9r9Q=\"; max-age=2592000; includeSubDomains" )
}

報告功能

加入 report-uri="https://example.com/hpkp-report",瀏覽器將以 JSON POST 發送違規資訊(含觀察到的指紋、預期指紋、URL、生效日期)。需自行建立接收端點解析入庫。

已知問題:Chrome 混淆 HSTS 與 HPKP 參數

Chrome ≤ 38 將 max-age、includeSubDomains 視為共用,導致 HSTS/HPKP 設定互相覆蓋。詳見 Chromium Issue 444511。建議暫時對齊兩者參數,或待瀏覽器修復後再部署。

部署檢查清單

  • 至少兩組有效 SPKI 指紋(一主一備)。
  • 備份金鑰離線保存,確保可續簽。
  • 先在測試環境驗證瀏覽器無誤判封鎖。
  • 設定 report-uri 監控違規嘗試。
  • 記錄 max-age 到期日,提前輪換金鑰。

HPKP 能大幅提升 HTTPS 信任鏈強度,但操作風險較高(金鑰遺失將導致網站不可訪問),建議成熟團隊配合完整金鑰管理流程後再啟用。

copyright © 萬盛學電腦網 all rights reserved