Lucy-XSS：双保险的XSS防护神器

Lucy-XSS是一个强大的开源库，它提供了两个防御模块——XssFilter和XssPreventer，用于保护Web应用程序免受跨站脚本（XSS）攻击。这个库基于白名单规则安全策略，并且目前的默认规则是Naver的标准。你可以根据需求自定义规则。

XssFilter：基于Java的安全过滤器

• 使用白名单方法保护Web应用，相比传统的黑名单方式提供更严密的安全保障。
• 支持DOM和SAX解析器，确保处理HTML内容时的全面安全性。

XssPreventer：快速防止XSS攻击

• 基于Apache Common Lang3库，简单地将所有输入字符串转换为HTML实体，使其在浏览器中无法识别为HTML标签。

< → &lt;
> → &gt;
" → &quot;
' → &#39;

XssFilter vs XssPreventer

• 对于非HTML文本参数，请使用XssPreventer进行过滤。
• 如果你需要接收包含HTML标签的输入（如邮件、访客簿或留言版服务），则应使用XssFilter。

获取与使用

最新的稳定版本是1.6.3，可以从中央Maven仓库直接获取：

<dependency>
    <groupId>com.navercorp.lucy</groupId>
    <artifactId>lucy-xss</artifactId>
    <version>1.6.3</version>
</dependency>

示例代码

XssPreventer

@Test
public void testXssPreventer() {
    String dirty = "\"><script>alert('xss');</script>";
    String clean = XssPreventer.escape(dirty);

    assertEquals(clean, "&quot;&gt;&lt;script&gt;alert(&#39;xss&#39;);&lt;/script&gt;");
    assertEquals(dirty, XssPreventer.unescape(clean));
}

XssFilter - SAX

@Test
public void testSuperSetFix() {
    XssSaxFilter filter = XssSaxFilter.getInstance("lucy-xss-superset-sax.xml");
    String expected = "<TABLE class=\"Naver_Layout_Main\" style=\"TABLE-LAYOUT: fixed\" cellSpacing=\"0\" cellPadding=\"0\" width=\"743\">" + "</TABLE>" + "<SPAN style=\"COLOR: #66cc99\"></SPAN>";
    String actual = filter.doFilter(clean);
    assertEquals(expected, actual);
}

XssFilter - DOM

@Test
public void pairQuoteCheckOtherCase() {
    XssFilter filter = XssFilter.getInstance("lucy-xss-superset.xml");
    // ...
}

更多的使用示例和技术细节，可以参考官方提供的韩语指南。

参与贡献

如果你有兴趣参与Lucy-XSS的开发，欢迎查阅贡献指南（准备中）。

相关项目

• lucy-xss-servlet-filter: 一个Java Servlet过滤器库，用于防止Web应用程序的XSS攻击。

许可证

Lucy-XSS遵循Apache License 2.0许可。

维护者

项目由以下人员维护：

• leeplay
• Seongmin Woo
• Jaehee Ahn

加入我们，一起构建更安全的互联网环境！