配置 wallfilter

这个文档提供基于Spring的各种配置方式

使用缺省配置的WallFilter

  <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">
      ...
      <property name="filters" value="wall"/>
  </bean>

结合其他Filter一起使用

WallFilter可以结合其他Filter一起使用，例如：

  <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">
      ...
      <property name="filters" value="wall,stat"/>
  </bean>

这样，拦截检测的时间不在StatFilter统计的SQL执行时间内。

如果希望StatFilter统计的SQL执行时间内，则使用如下配置

  <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">
      ...
      <property name="filters" value="stat,wall"/>
  </bean>

指定dbType

有时候，一些应用框架做了自己的JDBC Proxy Driver，是的DruidDataSource无法正确识别数据库的类型，则需要特别指定，如下：

  <bean id="wall-filter" class="com.alibaba.druid.wall.WallFilter">
      <property name="dbType" value="mysql" />
  </bean>

  <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">
      ...
      <property name="proxyFilters">
          <list>
              <ref bean="wall-filter"/>
          </list>
      </property>
  </bean>

指定配置装载的目录

缺省情况下，配置装载的目录如下：

数据库类型	目录
mysql	META-INF/druid/wall/mysql
oracle	META-INF/druid/wall/oracle
sqlserver	META-INF/druid/wall/sqlserver

从配置目录中以下文件中读取配置：

  permit-variant.txt
  permit-schema.txt
  permit-function.txt
  permit-table.txt
  permit-object.txt

指定配置装载的目录是可以指定，例如：

  <bean id="wall-filter-config" class="com.alibaba.druid.wall.WallConfig" init-method="init">
      <!-- 指定配置装载的目录  -->
      <property name="dir" value="META-INF/druid/wall/mysql" />
  </bean>
   
  <bean id="wall-filter" class="com.alibaba.druid.wall.WallFilter">
      <property name="dbType" value="mysql" />
      <property name="config" ref="wall-filter-config" />
  </bean>
   
  <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">
      ...
      <property name="proxyFilters">
          <list>
              <ref bean="wall-filter"/>
          </list>
      </property>
  </bean>

WallConfig详细说明

本身的配置

配置项	缺省值
dir	按照dbType分别配置: mysql : META-INF/druid/wall/mysql oracle : META-INF/druid/wall/oracle sqlserver : META-INF/druid/wall/sqlserver

拦截配置－语句

配置项	缺省值	描述
selelctAllow	true	是否允许执行SELECT语句
selectAllColumnAllow	true	是否允许执行SELECT * FROM T这样的语句。如果设置为false，不允许执行select * from t，但select * from (select id, name from t) a。这个选项是防御程序通过调用select *获得数据表的结构信息。
selectIntoAllow	true	SELECT查询中是否允许INTO字句
deleteAllow	true	是否允许执行DELETE语句
updateAllow	true	是否允许执行UPDATE语句
insertAllow	true	是否允许执行INSERT语句
mergeAllow	true	是否允许执行MERGE语句，这个只在Oracle中有用
callAllow	true	是否允许通过jdbc的call语法调用存储过程
truncateAllow	false	truncate语句是危险，缺省关闭，若需要自行打开
commentAllow	false	是否允许语句中存在注释，Oracle的用户不用担心，Wall能够识别hints和注释的区别
noneBaseStatementAllow	false	是否允许非以上基本语句的其他语句，缺省关闭，通过这个选项就能够屏蔽DDL。
multiStatementAllow	false	是否允许一次执行多条语句，缺省关闭
describeAllow	false	是否允许执行mysql的describe语句，缺省关闭

如果把selectIntoAllow、deleteAllow、updateAllow、insertAllow、mergeAllow都设置为false，这就是一个只读数据源了。 ## 拦截配置－永真条件

配置项	缺省值	描述
selectWhereAlwayTrueCheck	true	检查SELECT语句的WHERE子句是否是一个永真条件
selectHavingAlwayTrueCheck	true	检查SELECT语句的HAVING子句是否是一个永真条件
deleteWhereAlwayTrueCheck	true	检查DELETE语句的WHERE子句是否是一个永真条件
updateWhereAlayTrueCheck	true	检查UPDATE语句的WHERE子句是否是一个永真条件

其他拦截配置

配置项	缺省值	描述
selectIntoOutfileAllow	false	SELECT ... INTO OUTFILE 是否允许，这个是mysql注入攻击的常见手段，缺省是禁止的
selectUnionCheck	true	检测SELECT UNION
mustParameterized	false	是否必须参数化，如果为True，则不允许类似WHERE ID = 1这种不参数化的SQL
strictSyntaxCheck	true	是否进行严格的语法检测，Druid SQL Parser在某些场景不能覆盖所有的SQL语法，出现解析SQL出错，可以临时把这个选项设置为false，同时把SQL反馈给Druid的开发者。

禁用对象检测配置

配置项	缺省值	描述
tableCheck	true	检测是否使用了禁用的表
schemaCheck	true	检测是否使用了禁用的Schema
functionCheck	true	检测是否使用了禁用的函数
objectCheck	true	检测是否使用了“禁用对对象”
variantCheck	true	检测是否使用了“禁用的变量”
readOnlyTables	空	指定的表只读，不能够在SELECT INTO、DELETE、UPDATE、INSERT、MERGE中作为"被修改表"出现<

Jdbc相关配置

配置项	缺省值	描述
metadataAllow	false	是否允许调用Connection.getMetadata方法，这个方法调用会暴露数据库的表信息
wrapAllow	true	是否允许调用Connection/Statement/ResultSet的isWrapFor和unwrap方法，这两个方法调用，使得有办法拿到原生驱动的对象，绕过WallFilter的检测直接执行SQL。

WallFiler配置说明

配置项	缺省值	描述
logViolation	false	对被认为是攻击的SQL进行LOG.error输出
throwException	true	对被认为是攻击的SQL抛出SQLExcepton
config
provider

刚开始引入WallFilter的时候，把logViolation设置为true，而throwException设置为false。就可以观察是否存在违规的情况，同时不影响业务运行。