J2EE文件上传漏洞修复指南

1. 文件上传漏洞概述

文件上传漏洞是Web应用中常见的安全风险，攻击者可能利用此漏洞上传恶意文件（如webshell、病毒等）到服务器，进而控制服务器或执行其他恶意操作。

2. 使用ESAPI验证文件名

ESAPI（OWASP Enterprise Security API）提供了强大的安全验证功能，可用于文件上传的安全防护。

2.1 ESAPI文件名验证方法

ESAPI提供了三种isValidFileName()方法：

boolean isValidFileName(String context, String input, boolean allowNull) throws IntrusionException;

boolean isValidFileName(String context, String input, boolean allowNull, ValidationErrorList errorList) throws IntrusionException;

boolean isValidFileName(String context, String input, List<String> allowedExtensions, boolean allowNull) throws IntrusionException;

参数说明：

• context: 用户出错时日志中的标识
• input: 待检查的文件名
• allowNull: 是否允许文件名为空
• errorList: 自定义的错误列表
• allowedExtensions: 自定义的白名单扩展名列表

2.2 核心验证逻辑

ESAPI的文件名验证主要执行以下检查：

1. 空值检查：

   if (isEmpty(input)) {
       if (allowNull) return null;
       throw new ValidationException(...);
   }
   

2. 路径规范化检查：

   canonical = new File(input).getCanonicalFile().getName();
   

3. 路径操纵检测：

   if (!input.equals(cpath)) {
       throw new ValidationException(...);
   }
   

4. 扩展名验证：

   Iterator<String> i = allowedExtensions.iterator();
   while (i.hasNext()) {
       String ext = i.next();
       if (input.toLowerCase().endsWith(ext.toLowerCase())) {
           return canonical;
       }
   }
   

2.3 配置扩展名白名单

默认允许的扩展名可在ESAPI.properties文件中配置：

HttpUtilities.ApprovedUploadExtensions

3. 文件大小限制

3.1 使用ServletFileUpload限制大小

ServletFileUpload upload = new ServletFileUpload(factory);
upload.setSizeMax(maxBytes);  // 设置最大上传大小

3.2 Spring MVC配置示例

在Spring MVC中，可以通过配置CommonsMultipartResolver来限制文件大小：

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <!-- 上传文件大小上限，单位为字节(10MB) -->
    <property name="maxUploadSize">
        <value>10485760</value>
    </property>
    <property name="defaultEncoding">
        <value>UTF-8</value>
    </property>
</bean>

4. 最佳实践建议

1. 文件名生成策略：

   • 建议由系统生成文件名，避免使用用户提供的原始文件名
   • 可采用md5(用户名)+System.currentTimeMillis()等规则生成唯一文件名

2. 扩展名控制：

   • 严格限制允许上传的文件扩展名
   • 使用白名单机制而非黑名单

3. 文件大小限制：

   • 根据业务需求设置合理的文件大小上限
   • 在应用层和服务器配置层都进行限制

4. 多层验证：

   • 前端进行初步验证（用户体验）
   • 后端进行严格验证（安全性）
   • 文件内容验证（如检查图片文件的魔数）

5. 存储安全：

   • 将上传文件存储在Web根目录之外
   • 设置适当的文件权限

通过以上措施，可以显著提高文件上传功能的安全性，有效防范文件上传漏洞带来的安全风险。