跨站請求偽造 (CSRF) 攻擊者誘導受害者在已登入的目標站點發起非預期請求(如修改密碼、轉帳)。防禦核心:**驗證請求來源合法性**。
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() {}
}
<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>
<!-- 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)) {
// 拒絕請求
}
csrf_token=random_value; SameSite=StrictX-CSRF-Token// 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")
SameSite=Strict/LaxReferer Filter 實作簡單、無侵入性,適合快速為舊系統加裝基礎防護。但**不能作為唯一防線**,必須配合 CSRF Token 機制。新專案請直接使用 Spring Security、Apache Shiro 等成熟框架內建的 CSRF 防護,並啟用 SameSite Cookie。