在 Tomcat 中设置 JDBCRealm

除了默认配置的 DataSourceRealm，Tomcat 还支持 JDBCRealm，它通过 JDBC 来访问记录在关系数据库里的认证信息。

JDBCRealm 的配置步骤如下：

1. 在 $TOMCAT_HOME\conf\server.xml 配置 <Reaml/> 元素。

   <Realm  className="org.apache.catalina.realm.JDBCRealm"driverName="com.mysql.jdbc.Driver"connectionURL="jdbc:mysql://localhost/tomcat"connectionName="root" connectionPassword="root"userTable="users" userNameCol="username" userCredCol="userpass"userRoleTable="roles" roleNameCol="userrole" />

   <Reaml /> 元素属性说明：

   属性	说明
   className	Tomcat 的 JDBCRealm 实现类
   driverName	JDBC 驱动类
   connectionURL	数据库连接地址
   connectionName	数据库登录用户
   connectionPassword	数据库登录密码
   userTable	用户表的表名
   userNameCol	用户表中用户列的列名
   userCredCol	用户表中密码列的列名
   userRoleTable	角色表的表名
   roleNameCol	角色表中的角色列

   注：<Realm/> 元素可以放在 <Engine/> 元素中，这时该 Realm 会被所有应用共享。 放在 <Host/> 元素中，会被该 Host 下的应用程序共享。放在 <Context/> 元素中，则只有对应的应用程序能被访问。

2. 将 JDBC 驱动 jar 文件放置在 $TOMCAT_HOME\lib 目录中。
3. 在数据库中创建用户表与角色表，表名和命名要与上述的配置一致。

   CREATE TABLE `users` (`username` varchar(32) NOT NULL,`userpass` varchar(32) NOT NULL,PRIMARY KEY (`username`)
   ) ENGINE=InnoDB DEFAULT CHARSET=utf8;CREATE TABLE `roles` (`username` varchar(32) NOT NULL,`userrole` varchar(32) NOT NULL,PRIMARY KEY (`username`,`userrole`)
   ) ENGINE=InnoDB DEFAULT CHARSET=utf8;

4. 在表中配置用户与角色信息。

   INSERT INTO `tomcat`.`users` (`username`, `userpass`) VALUES ('admin', 'admin');
   INSERT INTO `tomcat`.`users` (`username`, `userpass`) VALUES ('huey', 'huey');
   INSERT INTO `tomcat`.`users` (`username`, `userpass`) VALUES ('suer', 'suer');INSERT INTO `tomcat`.`roles` (`username`, `role`) VALUES ('admin', 'admin');
   INSERT INTO `tomcat`.`roles` (`username`, `role`) VALUES ('admin', 'common');
   INSERT INTO `tomcat`.`roles` (`username`, `role`) VALUES ('huey', 'common');
   INSERT INTO `tomcat`.`roles` (`username`, `role`) VALUES ('suer', 'common');
   INSERT INTO `tomcat`.`roles` (`username`, `role`) VALUES ('suer', 'vip');

5. 新建一个 Java Web 工程，编辑 web.xml 文件。
6. 配置 <security-role/> 元素来定义角色。

   <security-role>  <role-name>admin</role-name>  
   </security-role>
   <security-role>  <role-name>common</role-name>  
   </security-role> 
   <security-role>  <role-name>vip</role-name>  
   </security-role> 

7. 配置 <security-constraint/> 元素，指定角色可访问的资源集和可使用的 HTTP 方法。

   <security-constraint><web-resource-collection><web-resource-name>Public resources</web-resource-name><url-pattern>/home/*</url-pattern><http-method>HEAD</http-method><http-method>GET</http-method></web-resource-collection><auth-constraint><role-name>common</role-name></auth-constraint>
   </security-constraint><security-constraint><web-resource-collection><web-resource-name>Secret resources</web-resource-name><url-pattern>/blog/*</url-pattern><url-pattern>/photo/*</url-pattern><http-method>HEAD</http-method><http-method>GET</http-method><http-method>POST</http-method><http-method>PUT</http-method></web-resource-collection><auth-constraint><role-name>admin</role-name><role-name>vip</role-name></auth-constraint>
   </security-constraint>

8. 配置 <login-config/> 元素，指定认证方式为基本认证，并指定安全域。

   <login-config><auth-method>BASIC</auth-method><realm-name>hueyhome</realm-name>
   </login-config>

9. 测试。

   C:\Users\huey>curl -I -u "suer:suer" http://localhost:8080/helloweb/blog/index.html
   HTTP/1.1 200 OK
   Server: Apache-Coyote/1.1
   Pragma: No-cache
   Cache-Control: no-cache
   Expires: Thu, 01 Jan 1970 08:00:00 CST
   Accept-Ranges: bytes
   ETag: W/"261-1431758220107"
   Last-Modified: Sat, 16 May 2015 06:37:00 GMT
   Content-Type: text/html
   Content-Length: 261
   Date: Tue, 19 May 2015 11:44:20 GMT