跨站點腳本編制 - SpringBoot配置XSS過濾器（基於Jsoup）

1. 跨站點腳本編制

  風險：可能會竊取或操縱客戶會話和 cookie，它們可能用於模仿合法用戶，從而使黑客能夠以該用戶身份查看或變更用戶記錄以及執行事務。
  原因：未對用戶輸入正確執行危險字符清理。
  固定值：查看危險字符注入的可能解決方案。

2. pom.xml添加依賴

<dependency>
	<groupId>org.jsoup</groupId>
	<artifactId>jsoup</artifactId>
	<version>1.11.3</version>
</dependency>
<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-configuration-processor</artifactId>
	<optional>true</optional>
</dependency>

3. 添加Xss包裝類

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletRequestWrapper;

import org.jsoup.Jsoup;
import org.jsoup.safety.Whitelist;

import lombok.extern.slf4j.Slf4j;

/**
 * Xss包裝類
 * 
 * @author CL
 *
 */
@Slf4j
public class XssHttpServletRequestWrapper extends HttpServletRequestWrapper {

	/**
	 * 構造請求對象
	 * 
	 * @param request
	 */
	public XssHttpServletRequestWrapper(HttpServletRequest request) {
		super(request);
	}

	/**
	 * 獲取頭部參數
	 * 
	 * @param v 參數值
	 */
	@Override
	public String getHeader(String v) {
		String header = super.getHeader(v);
		if (header == null || "".equals(header)) {
			return header;
		}
		return Jsoup.clean(super.getHeader(v), Whitelist.relaxed());
	}

	/**
	 * 獲取參數
	 * 
	 * @param v 參數值
	 */
	@Override
	public String getParameter(String v) {
		String param = super.getParameter(v);
		if (param == null || "".equals(param)) {
			return param;
		}
		return Jsoup.clean(super.getParameter(v), Whitelist.relaxed());
	}

	/**
	 * 獲取參數值
	 * 
	 * @param v 參數值
	 */
	@Override
	public String[] getParameterValues(String v) {
		String[] values = super.getParameterValues(v);
		if (values == null) {
			return values;
		}
		int length = values.length;
		String[] resultValues = new String[length];
		for (int i = 0; i < length; i++) {
			// 過濾特殊字符
			resultValues[i] = Jsoup.clean(values[i], Whitelist.relaxed()).trim();
			if (!(resultValues[i]).equals(values[i])) {
				log.debug("XSS過濾器 => 過濾前：{} => 過濾后：{}", values[i], resultValues[i]);
			}
		}
		return resultValues;
	}
}

4. 配置文件添加配置

# 信息安全
security:
  xss:
    enable: true
    excludes:
      - /login
      - /logout
      - /images/*
      - /jquery/*
      - /layui/*

5. 添加Xss過濾器

import java.io.IOException;
import java.util.List;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

import javax.servlet.Filter;
import javax.servlet.FilterChain;
import javax.servlet.FilterConfig;
import javax.servlet.ServletException;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import javax.servlet.annotation.WebFilter;
import javax.servlet.http.HttpServletRequest;

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

/**
 * Xss過濾器
 * 
 * @author CL
 *
 */
@Component
@ConfigurationProperties(prefix = "security.xss")
@WebFilter(filterName = "XssFilter", urlPatterns = "/*")
public class XssFilter implements Filter {

	/**
	 * 過濾器配置對象
	 */
	FilterConfig filterConfig = null;

	/**
	 * 是否啟用
	 */
	private boolean enable;

	public void setEnable(boolean enable) {
		this.enable = enable;
	}

	/**
	 * 忽略的URL
	 */
	private List<String> excludes;

	public void setExcludes(List<String> excludes) {
		this.excludes = excludes;
	}

	/**
	 * 初始化
	 */
	@Override
	public void init(FilterConfig filterConfig) throws ServletException {
		this.filterConfig = filterConfig;
	}

	/**
	 * 攔截
	 */
	@Override
	public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain)
			throws IOException, ServletException {
		HttpServletRequest request = (HttpServletRequest) servletRequest;

		// 不啟用或者已忽略的URL不攔截
		if (!enable || isExcludeUrl(request.getServletPath())) {
			filterChain.doFilter(servletRequest, servletResponse);
			return;
		}
		XssHttpServletRequestWrapper xssHttpServletRequestWrapper = new XssHttpServletRequestWrapper(request);
		filterChain.doFilter(xssHttpServletRequestWrapper, servletResponse);
	}

	/**
	 * 銷毀
	 */
	@Override
	public void destroy() {
		this.filterConfig = null;
	}

	/**
	 * 判斷是否為忽略的URL
	 * 
	 * @param urlPath URL路徑
	 * @return true-忽略，false-過濾
	 */
	private boolean isExcludeUrl(String url) {
		if (excludes == null || excludes.isEmpty()) {
			return false;
		}
		return excludes.stream().map(pattern -> Pattern.compile("^" + pattern)).map(p -> p.matcher(url))
				.anyMatch(Matcher::find);
	}
}