Tomcat服务器REALM配置参考.doc

Tomcat服务器配置参考Realm组件概述Realm元素是一个包含用户名，密码和用户角色的数据库。角色与Unix的group类似。Realm的不同实现允许将Catalina集成到认证信息已经被创建和维护的环境中，然后利用这些信息来实现ContainerManagedSecurity，如ServletSpecification中所述。你可以在任何Catalina容器（Engine，Host或者Context）中嵌套Realm元素。另外，Engine或者Host的Realm会自动被低层次的容器继承，除非被明确覆盖。有关web应用中containermanagedsecurity的更多信息，参考FIXME-应用开发者这一部分中“ContainerManagedSecurity指南”的连接；有关配置和使用标准Realm实现的更多信息，参考FIXME-管理者这一部分中的"RealmConfigurationHOW-TO"连接。以下的描述使用变量$CATALINA_HOME来指Tomcat5安装的目录。大多数的相对路径都是以该目录为基准。但是，通过设置CATALINA_BASE目录，可以运行多个Tomcat5实例，这时你应该使用$CATALINA_BASE来作为目录基准，而不是使用$CATALINA_HOME。属性公共属性所有Realm的实现支持如下属性：属性描述className实现的Java类名。这个类必须实现org.apache.catalina.Realm接口。标准实现和大多数Catalina组件不一样的是，Realm有几个标准的实现。所以，必须使用className属性来选择你希望使用的实现。JDBCDatabaseRealm(org.apache.catalina.realm.JDBCRealm)JDBCDatabaseRealm将Catalina连接到一个关系数据库，通过正确的JDBC驱动访问,用来查询用户名，密码和他们相关的角色。由于查询是在每次必要的时候完成的，因此数据库的改变会马上反映到用来认证新登录的信息中。除了用来获取必需信息的数据库表名和列名以外，还有很多附加的属性用来配置到数据库的连接：属性描述connectionName建立JDBC连接时使用的数据库用户名connectionPassword建立JDBC连接时使用的数据库密码connectionURL建立数据库连接时传递给JDBC驱动的连接URLdigest用来对数据库中的用户密码编码的“消息摘要”算法的名称。如果没有指定，密码以明文方式存储。driverName连接到认证数据库的JDBC驱动的完整的Java类名roleNameCol“用户角色“表中的列名，包含了指定给对应用户的角色名称。userCredCol“用户”表中的列名，包含用户的可信数据（比如，密码）。如果设置了digest属性，则假定密码已经用了指定的算法进行编码，否则，假定密码是明文密码。userNameCol“用户”表和“用户角色”表中的列名，包含用户的用户名userRoleTable“用户角色”表名，必须包含userNameCol和roleNameCol指定的列。userTable用户表，必须包含userNameCol和userCredCol属性指定的列有关使用JDBCDatabaseRealm组件来设置containermanagedsecurity的更多信息，参考FIXME-NestedpointerintoHOW-TODataSourceDatabaseRealm(org.apache.catalina.realm.DataSourceRealm)DataSourceDatabaseRealm将Catalina连接到一个关系数据库，通过一个名为JDBCDatasource的JNDI访问，查询用户名，密码以及他们对应的角色。由于查询在每次需要的时候进行，因此数据库的变化会马上反映到用来认证新的登录的信息上。JDBCRealm使用单个数据库连接。这要求基于realm的认证之间同步，比如，同一时刻只允许一个认证。这对需要大量使用认证的应用程序来说是一个瓶颈。DataSourceDatabaseRealm支持并发的基于Realm的认证，允许JDBCDataSource处理优化问题，比如数据库连接池。有很多选项可以配置JNDIJDBCDatasource的名字，同时包括用来获取必要信息的数据库表名和列名。属性描述dataSourceNameRealm的JNDIJDBCDataSource的名字digest用来对存储在数据库中的用户密码编码的消息摘要算法的名称。如果没有指定，假定用户密码以明文方式存储。roleNameCol“用户角色“表中的列名，包含了指定给对应用户的角色名称。userCred