萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML5 教學

JavaScript 過濾 HTML 標籤與 XSS 防護:DOMPurify、CSP 與前端安全最佳實踐

前端 HTML 過濾的核心誤區與正確定位

許多開發者嘗試在前端「過濾惡意標籤」防禦 XSS,但**前端過濾無法作為主要防線**——攻擊者可繞過瀏覽器直接發送 API 請求。前端處理的正確定位:

  1. 使用者體驗:即時預覽、輸入提示
  2. 輔助防護:配合後端編碼、CSP 形成纵深防禦
  3. 資料清洗:送往後端前的格式正規化

業界標準方案:DOMPurify

DOMPurify 是經過安全審計、廣泛採用的 HTML 淨化庫,支援瀏覽器與 Node.js。

安裝與基本用法

// npm / yarn / pnpm
npm install dompurify

// ES Module
import DOMPurify from 'dompurify';

// CDN (瀏覽器)
<script src="https://cdn.jsdelivr.net/npm/dompurify@3.0.6/dist/purify.min.js"></script>

核心 API

// 1. 預設:保留安全標籤,移除危險屬性/標籤
const clean = DOMPurify.sanitize(userHTML);

// 2. 嚴格模式:僅保留純文字
const textOnly = DOMPurify.sanitize(userHTML, { ALLOWED_TAGS: [] });

// 3. 自訂允許清單(如富文本編輯器輸出)
const richText = DOMPurify.sanitize(userHTML, {
  ALLOWED_TAGS: ['p', 'br', 'b', 'i', 'em', 'strong', 'a', 'ul', 'ol', 'li', 'blockquote', 'h1', 'h2', 'h3'],
  ALLOWED_ATTR: ['href', 'target', 'rel', 'class', 'id'],
  // 強制 a 標籤加上安全屬性
  ADD_ATTR: ['target'],
  ADD_URI_SAFE_ATTR: ['href']
});

// 4. 回傳 TrustedHTML (配合 Trusted Types)
const trusted = DOMPurify.sanitize(userHTML, { RETURN_TRUSTED_TYPE: true });
element.innerHTML = trusted; // 滿足 Trusted Types 政策

進階配置選項

選項預設說明
ALLOWED_TAGS安全標籤清單覆蓋預設允許標籤
FORBID_TAGS[]額外禁止標籤
ALLOWED_ATTR安全屬性清單覆蓋預設允許屬性
FORBID_ATTR['on*', 'style', ...]額外禁止屬性(預設禁用事件處理器、style)
KEEP_CONTENTfalsetrue 時移除標籤但保留內容
SANITIZE_DOMfalsetrue 時接受 Document/Element 節點
RETURN_DOMfalsetrue 時回傳 DocumentFragment
RETURN_TRUSTED_TYPEfalsetrue 時回傳 TrustedHTML(需瀏覽器支援)

配合 Trusted Types 強制安全

Trusted Types 瀏覽器機制強制要求 innerHTML、document.write 等接收 TrustedHTML 物件,杜絕字串直接注入。

<meta http-equiv="Content-Security-Policy" 
      content="trusted-types dompurify; require-trusted-types-for 'script';">

// 應用層
const sanitized = DOMPurify.sanitize(input, { RETURN_TRUSTED_TYPE: true });
element.innerHTML = sanitized; // 僅接受 TrustedHTML

內容安全政策 (CSP) 最後防線

// 範例:嚴格 CSP
Content-Security-Policy: 
  default-src 'self';
  script-src 'self' 'nonce-{random}';  // 禁止 inline script
  style-src 'self' 'unsafe-inline';    // 允許 inline style (或用 nonce)
  img-src 'self' data: https:;
  font-src 'self' data:;
  object-src 'none';
  base-uri 'self';
  form-action 'self';
  frame-ancestors 'none';

輸入驗證 vs 輸出編碼 vs 過濾

階段動作工具/方法目的
輸入驗證格式、長度、型別Zod, Yup, Joi, filter_var商務邏輯正確性
儲存參數化查詢,原始儲存PDO, ORM防 SQL 注入,保留原始資料
輸出(HTML)情境化編碼htmlspecialchars, 模板引擎自動逃逸防 XSS 核心
輸出(JS)JSON 編碼json_encode, JSON.stringify防 JS 注入
瀏覽器CSP、Trusted TypesHTTP Header、Meta 標籤縱深防禦、限制注入面

快速檢查清單

  • ☐ 所有使用者輸入輸出到 HTML 皆經過編碼/模板引擎自動逃逸
  • ☐ 富文本內容使用 DOMPurify 淨化並設定嚴格允許清單
  • ☐ 已部署 CSP Header(含 script-src、object-src 'none')
  • ☐ 已啟用 Trusted Types(現代瀏覽器)
  • ☐ Cookie 設定 HttpOnly、Secure、SameSite=Strict/Lax
  • ☐ 定期進行滲透測試與依賴掃描

前端 HTML 過濾以 DOMPurify 為標準工具,但真正的 XSS 防護在於「輸出端情境化編碼」與「瀏覽器安全機制(CSP/Trusted Types)」,三者缺一不可。

copyright © 萬盛學電腦網 all rights reserved