Next.js 安全性
優先級:P0(關鍵)
結構
app/
├── lib/
│ └── validation.ts # 共享的 Zod schema
└── middleware.ts # 身份驗證與標頭
實作指南
- Next.js 中介軟體:使用
middleware.ts 進行邊緣端身份驗證、角色權限控管(RBAC),並強制執行安全標頭(例如 Content-Security-Policy (CSP)、X-XSS-Protection)。
- Server Actions:務必使用 Zod 對來自
FormData 或 JSON 的所有輸入進行消毒。在每個 action 內部執行身份驗證檢查(await auth())以驗證呼叫者身份。
- 資料污染:使用
experimental_taint API(taintObjectReference)確保敏感的伺服器物件(例如含有 passwordHash 的 User)絕不會洩漏到客戶端元件中。
- 路由處理器(
route.ts):實作速率限制以防止暴力破解或 DoS 攻擊。驗證 Origin/Referer 標頭以減緩 CSRF(跨站請求偽造)。
- 身份驗證 Token:嚴格使用
HttpOnly、Secure cookie,並搭配 SameSite: 'Lax' 進行 session 管理。絕不將 Token 儲存在 localStorage 中。
- 邏輯隔離:使用
server-only 套件防止後端專用邏輯被包含在客戶端 bundle 中。
- 元件純淨性:跳脫所有使用者提供的內容。絕不直接使用
dangerouslySetInnerHTML,除非搭配像 DOMPurify 這樣的消毒器。
反模式
- 不要將資料庫欄位洩漏給客戶端:使用 DTO(資料傳輸物件);絕不直接傳遞原始模型物件。
- 不要在客戶端 bundle 中使用
process.env:僅在安全揭露的情況下標記為 NEXT_PUBLIC_。
- 不要使用未經驗證的 Server Action 輸入:始終使用 Zod schema 進行驗證。
- 不要在共用佈局中進行身份驗證檢查:在佈局中進行驗證是不安全的;請使用中介軟體。
參考資料