萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> JSP 程式設計

JSP 防止跨域提交(CSRF)Filter 實戰:Referer 驗證與白名單機制

威脅模型

跨站請求偽造 (CSRF) 攻擊者誘導受害者在已登入的目標站點發起非預期請求(如修改密碼、轉帳)。防禦核心:**驗證請求來源合法性**。

Referer 驗證 Filter 完整實作

package com.example.security;

import javax.servlet.*;
import javax.servlet.http.*;
import java.io.IOException;
import java.util.Enumeration;
import org.apache.commons.logging.*;

public class CsrfRefererFilter implements Filter {
    private static final Log LOG = LogFactory.getLog(CsrfRefererFilter.class);
    
    // 白名單:不檢查 Referer 的 URI 前綴
    private static final String[] IGNORE_URIS = {
        "/login", "/register", "/public/", "/api/open/", "/error"
    };
    
    @Override
    public void init(FilterConfig config) { /* 可從配置檔讀取白名單 */ }

    @Override
    public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain)
            throws IOException, ServletException {
        HttpServletRequest request = (HttpServletRequest) req;
        HttpServletResponse response = (HttpServletResponse) res;
        
        String requestUri = request.getRequestURI();
        String contextPath = request.getContextPath();
        String serverName = request.getServerName().toLowerCase();
        
        // 1. 白名單檢查
        for (String ignore : IGNORE_URIS) {
            if (requestUri.startsWith(contextPath + ignore)) {
                chain.doFilter(req, res);
                return;
            }
        }
        
        // 2. 取得 Referer 標頭
        String referer = request.getHeader("Referer");
        if (referer == null || referer.isEmpty()) {
            LOG.warn("CSRF 阻擋: 缺少 Referer 標頭 - URI: " + requestUri);
            redirectToHome(response, contextPath);
            return;
        }
        
        // 3. 解析 Referer 主機
        String refererHost;
        try {
            // 移除協議
            int protocolEnd = referer.indexOf("://");
            if (protocolEnd == -1) throw new IllegalArgumentException();
            String afterProtocol = referer.substring(protocolEnd + 3);
            // 取主機部分(含 port)
            int pathStart = afterProtocol.indexOf('/');
            refererHost = (pathStart == -1) ? afterProtocol : afterProtocol.substring(0, pathStart);
            refererHost = refererHost.toLowerCase();
        } catch (Exception e) {
            LOG.warn("CSRF 阻擋: Referer 格式異常 - " + referer);
            redirectToHome(response, contextPath);
            return;
        }
        
        // 4. 比對主機
        // 允許子域名?視業務決定。此處嚴格比對完整 host:port
        String currentHost = serverName;
        int port = request.getServerPort();
        if ((port != 80 && port != 443)) {
            currentHost += ":" + port;
        }
        
        if (!refererHost.equals(currentHost)) {
            LOG.warn("CSRF 阻擋: Referer 主機不符 - 期望: " + currentHost + ", 實際: " + refererHost);
            redirectToHome(response, contextPath);
            return;
        }
        
        // 5. 通過檢查
        chain.doFilter(req, res);
    }
    
    private void redirectToHome(HttpServletResponse response, String contextPath) 
            throws IOException {
        response.sendRedirect(contextPath + "/index.jsp");
    }

    @Override
    public void destroy() {}
}

web.xml 註冊

<filter>
    <filter-name>csrfRefererFilter</filter-name>
    <filter-class>com.example.security.CsrfRefererFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>csrfRefererFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

Referer 驗證的局限性

  • **可被瀏覽器/防火牆/代理移除**:隱私模式、某些防毒軟體會刪除 Referer
  • **子域名/同域不同埠** 需額外處理
  • **HTTPS → HTTP** 請求不發送 Referer (RFC 7231)

最佳實踐:雙重防護(Token + Referer)

1. 同步 Token 模式(推薦核心防禦)

<!-- JSP 表單植入 Token -->
<input type="hidden" name="${csrf.tokenName}" value="${csrf.tokenValue}">
// Filter 驗證 Token
String sessionToken = (String) session.getAttribute("CSRF_TOKEN");
String requestToken = request.getParameter("csrfToken");
if (sessionToken == null || !sessionToken.equals(requestToken)) {
    // 拒絕請求
}

2. Double Submit Cookie 模式(無狀態)

  • 伺服器設定 Cookie: csrf_token=random_value; SameSite=Strict
  • 前端讀取 Cookie 值放入請求 Header: X-CSRF-Token
  • 後端比對 Header 值與 Cookie 值

3. SameSite Cookie 屬性(現代瀏覽器原生防禦)

// Servlet 3.0+ (Tomcat 8.5+)
Cookie sessionCookie = new Cookie("JSESSIONID", sessionId);
sessionCookie.setHttpOnly(true);
sessionCookie.setSecure(true);
sessionCookie.setPath("/");
// SameSite 需透過反射或升級 Servlet 4.0+ 使用 setAttribute("SameSite", "Strict")

完整防護策略建議

  1. 核心:所有狀態改變操作 (POST/PUT/DELETE) 強制驗證 CSRF Token
  2. 輔助:Referer 檢查作為第二層防線,攔截 Token 洩露場景
  3. 現代:設定 Session Cookie SameSite=Strict/Lax
  4. 例外:公開 API、靜態資源、登入/註冊頁放行
  5. 審計:記錄所有攔截日誌,定期分析攻擊來源

總結

Referer Filter 實作簡單、無侵入性,適合快速為舊系統加裝基礎防護。但**不能作為唯一防線**,必須配合 CSRF Token 機制。新專案請直接使用 Spring Security、Apache Shiro 等成熟框架內建的 CSRF 防護,並啟用 SameSite Cookie。

copyright © 萬盛學電腦網 all rights reserved