Tomcat 基本配置
tomcat读取配置文件
首先简单说一下tomcat是如何读取配置文件的。tomcat在启动时,首先找系统变量CATALINA_BASE,若是没有,则找CATALINA_HOME。而后找这个变量所指的目录下的conf文件夹,从中读取配置文件。
最重要的配置文件:server.xml
要配置tomcat,基本上了解server.xml,context.xml和web.xml就能够了。在Tomcat中,都有这几个文件的默认文件,如server.xml的内容以下:
- <Server port=”8005” shutdown=”SHUTDOWN”>
- ...
- <Service name=”Catalina”>
- <Connector port=”8080” protocol=”HTTP/1.1”
- maxThreads=”150” connectionTimeout=”20000”
- redirectPort=”8443” />
- <Connector port=”8009” protocol=”AJP/1.3” redirectPort=”8443” />
- <Engine name=”Catalina” defaultHost=”localhost”>
- <Realm className=”org.apache.catalina.realm.UserDatabaseRealm”
- resourceName=”UserDatabase”/>
- <Host name=”localhost” appBase=”webapps”
- unpackWARs=”true” autoDeploy=”true”
- xmlValidation=”false” xmlNamespaceAware=”false”>
- </Host>
- </Engine>
- </Service>
- </Server>
The Server Component
- <Server port=”8005” shutdown=”SHUTDOWN”>
顶层元素为<server>,这个元素对应着Tomcat结构中的server部分。这一行的意思是让Tomcat在8005端口 监听关闭消息,若是使用telnet链接8005端口并输入SHUTDOWN,则tomcat就会关闭。为了安全,tomcat不会接受远程经过这个端口 发的消息。
<Server>还有一些其余属性,若是不作配置的话,这些属性将使用默认值,下面是这些属性的介绍。
属性 |
描述 |
是否必须? |
className |
表示server的类,须要实现org.apache.catalina.Server接口。tocmat6默认值使用rg.apache.catalina.core.StandardServer |
否 |
port |
用来监听shutdown属性所对应的那个命令,实现关闭tomcat操做的TCP端口。tocmat会检查链接是否来自同一台机器,只有同一台机器(物理地址)发来的消息才被接受。 |
是 |
shutdown |
tomcat会监听port所规定的端口,来接受这个属性所规定的命令 |
是 |
<Server>还有一些子标签,内容以下:
属性 |
描述 |
数量 |
<Service> |
包括一组和一个<Engine>相关联的<Connector>。这些Connector能够并发地接收各类协议的请求,并交给<Engine>来处理 |
1 or more |
<Listener> |
用来监听Server生命周期(start, stop, before start, after start, before stop, after stop)信息 |
0 or more |
<GlobalNamingResources> |
整个tomcat实例均可以使用的JNDI资源 |
0 or more |
The Service Component
Service component包括一组Connector和一个Engine,这些Connector监听不一样端口不一样协议的请求,而且这些Connector是并 发执行的,Engine则被用来处理这些请求。在默认的server.xml中,service标签的内容以下:
<Service name=”Catalina”>
<service>能够有如下属性:
属性 |
描述 |
必需? |
className |
service compoent所对应的java类,默认实现org.apache.catalina.core.StandServic |
否 |
name |
service的name,一般在administration,management和logging中使用 |
是 |
<service>拥有这些子元素:
子元素 |
描述 |
数量 |
Connector |
做用为处理外部的链接请求并将其发送给Engine处理。一个Connector拥有几个线程和相应资源来处理这些请求。 |
1 or more |
Engine |
经常使用类型有两种,Catalina和Standalone。Engine是用来处理Connector发过来的请求的。 |
1 |
The Connector Component
tomcat6提供了两种Connector,分别为HTTP/1.1和AJP/1.3。这两种Connector在默认的server.xml中的配置为:
- <Connector port=”8080” protocol=”HTTP/1.1”
- maxThreads=”150” connectionTimeout=”20000”
- redirectPort=”8443” />
- <Connector port=”8009” protocol=”AJP/1.3” redirectPort=”8443” />
The Engine Component
Engine在server.xml中的代码以下:
- <Engine name=”Catalina” defaultHost=”localhost”>
- ...
- </Engine>
一个Engine就是一个容器,servlet容器。一个Engine能够处理多个虚拟Host(apache中的概念)的请求。当Engine不知该将请求交给那个host时,Engine则将请求转给defaultHost来处理。
<Engine>的属性以下表所示:
属性 |
描述 |
必需? |
className |
Engine所对应的java类,默认使用org.apache.catalina.core.StandardEngine |
否 |
backgroundProcessDelay |
单位为秒,在这个属性所定义的时间以后,此Engine将进入后台处理。若是该值为负,则直接进入后台处理。后台处理通常用于处理低优先级的任务。
|
否 |
defaultHost |
当Engine找不到请求对应的host时,就使用这个host |
是 |
jvmRoute |
这是tomcat6在负载均衡中使用的标识符, |
否 |
name |
Engine的名称 |
是 |
做为一个容器,Engine有许多子元素,具体内容以下表:
子元素 |
描述 |
数量 |
Host |
每一个<Host>元素都表示一个由Engine支配的虚拟主机(virtual host) |
1 or more |
Context |
一组属性-元素的配置集合。在默认的context定义的属性能够被Engine中全部的web应用程序所使用。 |
0 or 1 |
Realm |
用于身份验证等安全机制,Engine和Context均可以由Realm。若是不指定,则使用Engine的Realm。 |
0 or 1 |
Valve |
Standard Valve用于登录日志,请求过滤等 |
0 or more |
Listener |
用于tomcat生命周期控制 |
0 or more |
The Realm Component
在默认的server.xml中,Engine中的第一个子标签就是<Realm>了,其代码以下:
- <Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase"/>
这段代码是对一个UserDatabase Realm的配置,它让默认的web应用程序(manager)加载tomcat-user.xml来进行用户验证。
Realm能够从不少其余数据源获取验证数据,而这也正是不一样的Realm的不一样之处。通常地,Realm能够从这些数据源获取用户验证数据:
- 内存(memory):使用在内存中存放的一个表格进行验证。这个表格时在tomcat启动时从一个xml文件加载到内存中的,在这个表格中的信息格式通常为:用户名/密码/角色。这种方式通常只用于测试和开发阶段,最终产品不多使用这种方式
- UserDatabase:实现了一个能够修改的、持久的memory Realm,能够向后兼容memory Realm。
- JDBC:使用一个关系数据库存放用户验证数据
- DataSource:相似于JDBC Realm,使用JNDI的方式来从关系数据库中拿用户验证数据,内容最终仍是在一个关系数据库里。
- JNDI:使用JNDI来获取Realm数据,这些数据通常存放在LDAP目录下。
- JAAS: 使用JAAS来获取用户验证信息
The Host Component
每一个Host Component都是一个容器,每一个<Host>标签都表示一个virtual host,在默认的<server.xml>中,Host的配置以下:
- <Host name=”localhost” appBase=”webapps”
- unpackWARs=”true” autoDeploy=”true”
- xmlValidation=”false” xmlNamespaceAware=”false”>
这段代码的意思是:定义一个名为localhost的虚拟主机,应用程序存放在CATALINA_HOME/webapps目录中。 unpackWARs=“true”让tomcat在webapps文件夹中发现war文件时,自动将其解压。解压的好处是可使程序运行更快,不解压也 可使用。
下图为virtual host的示意图
<Host>有这些属性:
属性 |
描述 |
必需? |
className |
默认为org.
apache.catalina.core.StandardHost
|
否 |
appBase |
web应用程序文件存放的位置,相对路径为CATALINA_HOMEM |
是 |
autoDeploy |
设为true,则web.xml发生变化时,tomcat自动从新部署程序。实现这个功能必需容许后台处理 |
否 |
name |
virtual host的名称 |
是 |
backgroundProcessingDelay |
跟Engine中的backgroundProcessingDelay相似 |
否 |
deployOnStartup |
若为true,则当这个Engine启动时,tomcat将自动部署这个host,默认为true |
否 |
deployXML |
这个属性的目的是为了提升tomcat的安全性,控制web应用程序是否能使用META-INF/contex.xml。若是设为false,则各应用程序只能访问
$CATALINA_HOME/conf/<engine>/<host>/<app>.xml。默认值为True。
|
否 |
errorReportValveClass |
定义host使用的error-reporting Valve,默认值为
org.apache.catalina.valves.ErrorReportValve
|
否 |
unpackWARs |
tomcat在webapps文件夹中发现war文件时,是否自动将其解压 |
否 |
workdir |
tomcat使用这个目录来放工做着的servlet和jsp(以servlet形式),这里面的servlet都是是编译好的class文件。默认为$CATALINA_HOME/work |
否 |
<Host>有这些子标签
子元素 |
描述 |
数量 |
Context |
为了实现服务器配置和应用程序配置的分离,通常不会在server.xml中设置这个标签的内容。全部应用程序的配置均可以 在$CATALINA_HOME/conf/<engine>/<host>目录下维护,名称为:应用程序名.xml。程序员可 以经过在META-INF目录下维护本身的context.xml,这个context.xml会被自动以“应用程序名.xml”放 到$CATALINA_HOME/conf/<engine>/<host> |
0 or more |
DefaultContext |
当host不知将请求发给哪一个context时,就发给它 |
0 or 1 |
Realm |
这个Host所使用的Realm |
0 or 1 |
Web Application Context Definitions
在tomcat6中,web应用程序的具体配置是在$CATALINA_HOME/conf/<engine name>/<host name>目录下的“应用程序名.xml”中定义的,在eclipse或netbeans中,用户能够在META-INF/context.xml 中作配置,这些IDE会自动在$CATALINA_HOME/conf/<engine name>/<host name>下建立“应用程序名.xml”文件。
在war包(或文件夹)的META-INF中的配置文件叫作嵌入式配置文件(embedded),默认tomcat在部署时使用这些配置文件,管理员能够经过修改deployXML属性来禁止解析这种嵌入式配置文件。
默认context.xml文件
在$CATALINA_HOME/conf目录下的context.xml是tomcat默认的context.xml文件,tomcat下所 有的应用程序都使用这个文件的配置。由于它是公共的,所以里面的内容必须是全部web应用程序通用的,默认的context.xml内容只有一行:
- <Context>
- <WatchedResource>WEB-INF/web.xml</WatchedResource>
- </Context>
在这里的web.xml被Context的一个后台程序监视,一旦发生改变,将从新部署这个Context。
context有如下这些属性:
属性 |
描述 |
必需? |
className |
Context的java类,默认为org.apache.catalina.core.StandardContext |
否 |
allowLinking |
在像linux这种容许符号连接(symbolic link)的操做系统中,这个选项为True则运行该文件被连接到web应用程序树以外。在windows中,这个选项必需为false。默认值为false |
否 |
antiJARLocking |
使用特殊的类加载器来尽可能避免JAR文件的锁定,默认为false。 |
否 |
antiResourceLocking |
使用特殊方法来尽可能避免文件锁定,默认为false。 |
否 |
backgroundProcessDelay |
同其余backgroundProcessDelay |
否 |
catcheMaxSize |
设置资源代码(resource code)的最大值,默认为10240,单位为KB |
否 |
catcheTTL |
验证cache的间隔时间,单位为微秒,默认值为5000 |
否 |
cachingAllowed |
决定静态资源(配置文件,图片等)是否能够加载进cache中,默认为true |
否 |
caseSensitive |
决定tocmat是否进行大小写检查,默认为true |
否 |
cookies |
使用cookie来进行session管理,默认为true。若是设为false,则须要使用url重写的方式维护session |
否 |
crossContext |
当使用ServletContext.getContext()方法时,容许同一个virtual host下的程序跨Context访问,默认为false
|
否 |
docBase |
在这个Context下运行的web应用程序的文档根目录,一般被称为Context root。若是web应用程序是以war文件的方式部署的,那么这个属性的默认值为webapps/<name of war file>
|
否 |
override |
指示本地的context.xml(war中的META-INF/context.xml)是否能够覆盖全局的context.xml(CATALINA_HOME/conf/context.xml),默认值为false |
否 |
path |
表示web应用程序的context路径。若是你想将这个web应用程序做为此host的默认应用程序,使用这个值:“”;默认值为docBase,war包名,或者应用程序Context文件名 |
否 |
privileged |
默认值为false,大部分程序这个值设为false就能够了 |
否 |
processTlds |
设置当Context启动时对TLD进行预处理,默认为true |
否 |
reloadable |
默认值为false。设置tocmat是否应该监视/WEB-INF/classes和/WEB-INF/lib中的变化,若是有发生改变,则自动从新部署 |
否 |
swallowOutput |
默认为false。设置System.out和System.error的内容是否应该记录到日志文件中 |
否 |
tldNamespacheAware |
设置tld的处理和验证是不是namespace-aware,默认为false |
否 |
unloadDelay |
tomcat等待web应用程序卸载的微秒数,默认为2000 |
否 |
unpackWAR |
默认为true。设置tomcat自动解压docBase中的war文件。 |
否 |
useNaming |
默认为true。给web应用程序建立一个JavaEE-JNDI兼容的 InitialContext。若是web应用程序使用数据库链接,这个选项是必需的 |
否 |
workdir |
为在这个host中运行的servlet定义一个工做目录。这个host下的应用程序能够经过javax.servlet.context.tempdir属性来活动这个目录的位置。默认为CATALINA_HOME/work |
否 |
wrapperClass |
设置一个实现了org.apache.catalina.Wrapper接口的类r来包装servlets |
否 |
<context>有这些子元素:
子元素 |
描述 |
数量 |
Loader |
配置用于从一个web应用程序中加载类的ClassLoader |
0 or 1 |
Manager |
配置Context的session manager,Session Manager建立,维护并保持服务器端的session。 |
0 or 1 |
Realm |
这个Context中运行的web应用程序使用的Realm |
0 or 1 |
Resources |
用于获取resource。使用实现org.apache.naming.resources.FileDirContext接口的类来实现。 |
0 or 1 |
WatchedResource |
当特定的资源发生改变时,用于通知AutoDeployer对web应用程序进行从新部署 |
0 or 1 |
身份验证和tomcat-users.xml
tomcat-users.xml位于$CATALINA_HOME/conf文件夹下,tomcat6使用这个文件来对使用manager工具的用户 (也就是管理员)进行身份验证。tomcat6使用UserDatabase Realm来具体实现这个功能。Realm容许修改加载的数据,并能够经过将这些修改写回xml的方式来使这些修改持久化。
默认的部署配置文件--web.xml
根据servlet2.5的标准,任何一个servlet都必须在web.xml中注册,这个文件必须以web.xml放到web应用程序的WEB-INF目录下。这样能够这个web.xml就只对这个web应用程序有做用。
在$CATALINA_HOME/conf下也有一个web.xml,这个web.xml是这个tomcat实例下全部web应用程序均可以使 用的。不过能够在context中修改orverride属性,来决定各web应用程序的web.xml是否能够覆盖全局的web.xml。
下面是默认的全局web.xml:
- <?xml version=”1.0” encoding=”ISO-8859-1”?>
- <web-app xmlns=”http://java.sun.com/xml/ns/j2ee”
- xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”
- xsi:schemaLocation=”http://java.sun.com/xml/ns/j2ee web-app_2_4.xsd”
- version=”2.4”>
与server.xml不一样,web.xml能够用schema进行验证。
默认Server上静态资源的配置
在下面的<servlet>标签中,定义了一个默认的servlet。这个默认的servlet是用来处理全部web应用程序的静 态资源请求的,也能够提供目录展现(directory listing)服务。也就是说,这个servlet至关于一个像apache这样的http web server。
在默认的web.xml中对默认servlet的配置:
- <servlet>
- <servlet-name>default</servlet-name>
- <servlet-class>
- org.apache.catalina.servlets.DefaultServlet
- </servlet-class>
- <init-param>
- <param-name>debug</param-name>
- <param-value>0</param-value>
- </init-param>
- <init-param>
- <param-name>listings</param-name>
- <param-value>true</param-value>
- </init-param>
- <load-on-startup>1</load-on-startup>
- </servlet>
默认目录列表和其余用户自定义配置
若是你不想提供用户列表功能,能够将下面代码段中的true改成false
- <param-name>listings</param-name>
- <param-value>true</param-value>
默认servlet(default servlet)还有这些属性:
参数 |
描述 |
listing |
当有到一个目录的请求时,是否显示目录结构,通常设为true。 |
readonly |
控制是否容许PUT,POST等HTTP写命令 |
input |
读取资源时的缓冲区大小,通常为2KB |
output |
写资源时的缓冲区大小,通常也为2KB |
globalXsltFile/localXsltFile |
定义一个显示目录列表时使用的xslt。 |
sendfileSize |
tomcat6支持基于某个具体操做系统平台的异步sendfile()。这个值用来设置使用sendfile()方法的阀值,默认为48KB。 |
配置invoker servlet
invoker servlet是能够经过下面这种方式直接访问的servlet(没有参数)
http://<host name>/<context path>/servlet/<servlet name>
由于这种方式能够直接访问servlet,所以存在必定的安全隐患,因此这种方式应该仅在开发和测试阶段使用,也正由于这个缘由,在tomcat6的默认web.xml中invoker servlet这段配置被注释了起来:
- <!--
- <servlet>
- <servlet-name>invoker</servlet-name>
- <servlet-class>
- org.apache.catalina.servlets.InvokerServlet
- </servlet-class>
- <init-param>
- <param-name>debug</param-name>
- <param-value>0</param-value>
- </init-param>
- <load-on-startup>2</load-on-startup>
- </servlet>
- -->
配置JspServlet(Jasper)
JspServlet的做用是将jsp文件转为servlet。这个servlet通常被人们成为Jasper,Jasper的配置以下:linux
- JspServlet的做用是将jsp文件转为servlet。这个servlet通常被人们成为Jasper,Jasper的配置以下:
- <servlet>
- <servlet-name>jsp</servlet-name>
- <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class>
- <init-param>
- <param-name>fork</param-name>
- <param-value>false</param-value>
- </init-param>
- <init-param>
- <param-name>xpoweredBy</param-name>
- <param-value>false</param-value>
- </init-param>
- <load-on-startup>3</load-on-startup>
- </servlet>
Jasper还有如下这些启动参数:
参数 |
描述 |
development |
默认值为true,说明jsp文件还处于开发阶段,所以Jasper应该按modificationTestInterval参数对jsp文件进行检查,当jsp发生更改时,则对其进行重编译 |
fork |
默认值为true。指示使用不一样的JVM编译JSP,这样能够消除资源竞争和在开发阶段的类加载器冲突 |
checkInterval |
单位为秒,规定Jasper按这个时间间隔检查jsp是否须要重编译,默认为0,指示使用后台程序处理 |
modificationTestInterval |
主要在development为true时发挥做用,默认值为4。Jasper将按这个频率检查jsp文件是否能够验证是否修改过。 |
compiler |
读取资源时使用的缓存大小,默认为2KB |
classdebuginfo |
写资源时使用的缓存大小,默认为2KB |
keepgenerated |
默认值为true。指示Jasper在两次调用servlet之间在工做目录中保留那个servlet,这样能够大大提升tomcat的效率 |
mappedfilegenStrAsCharArray dumpSmaptrimSpaces supressSmap |
这些是jsp开发者使用的优化和调试选项。 |
scratchDir |
Jasper在编译jsp时使用的临时文件夹,默认为$CATALINA_HOME/work下的一个临时文件夹 |
xpoweredBy |
默认为false。功能为生成X-Power-By头(header) |
compilerTargetVM |
编译生成的servlet的目标VM |
compilerSourceVM |
生成servlet的源VM |
SSL和CGI Servlet的配置
在默认的web.xml中,这些Servlet的配置被注释起来了,若是你想在Standalone模式下的Tomcat中添加Apache-styleserver-side include(SSI),那么这段注释就应该被移除。
- <!--
- <servlet>
- <servlet-name>ssi</servlet-name>
- <servlet-class>org.apache.catalina.ssi.SSIServletServlet</servlet-class>
- <init-param>
- <param-name>buffered</param-name>
- <param-value>1</param-value>
- </init-param>
- <init-param>
- <param-name>debug</param-name>
- <param-value>0</param-value>
- </init-param>
- <init-param>
- <param-name>expires</param-name>
- <param-value>666</param-value>
- </init-param>
- <init-param>
- <param-name>isVirtualWebappRelative</param-name>
- <param-value>0</param-value>
- </init-param>
- <load-on-startup>4</load-on-startup>
- </servlet>
- -->
下面的这个配置也是有关使tomcat以Standalone方式处理CGI请求的。
- <!--
- <servlet>
- <servlet-name>cgi</servlet-name>
- <servlet-class>org.apache.catalina.servlets.CGIServlet</servlet-class>
- <init-param>
- <param-name>clientInputTimeout</param-name>
- <param-value>100</param-value>
- </init-param>
- <init-param>
- <param-name>debug</param-name>
- <param-value>6</param-value>
- </init-param>
- <init-param>
- <param-name>cgiPathPrefix</param-name>
- <param-value>WEB-INF/cgi</param-value>
- </init-param>
- <load-on-startup>5</load-on-startup>
- </servlet>
- -->
Servlet Mappings
<servlet-mapping>用来讲明如何处理相应的URL请求,如:
- <servlet-mapping>
- <servlet-name>default</servlet-name>
- <url-pattern>/</url-pattern>
- </servlet-mapping>
规则是这样的,若是传进来的url符合/模式,则传给名为default的Servlet处理。
例如,若是主机名为www.example.com,而且使用Standalone模式运行的tocmat,则下面这个请求将被传给<servlet-name>为default的Servlet:
www.example.com/<context path>/
若是没在<Context>中明确标明,则<context path>的值为war文件名
根据前面<servlet>中定义的<servlet-name>对应的servlet,能够知道tomcat将使用org.apache.catalina.servlets.DefaultServlet来处理这个模式的请求
下面的这两个<servlet-mapping>标签指示全部包含*.jsp和*.jspx的url都将传给名为jsp的servlet处理。
- <servlet-mapping>
- <servlet-name>jsp</servlet-name>
- <url-pattern>*.jsp</url-pattern>
- </servlet-mapping>
- <servlet-mapping>
- <servlet-name>jsp</servlet-name>
- <url-pattern>*.jspx</url-pattern>
- </servlet-mapping>
server.xml,context.xml和web.xml是如何一块儿协同工做的
下面这幅图是对tomcat处理一个http请求的一个示意
SSI和CGI mappings
在web.xml中,SSI和CGI的<servlet-mapping>的配置被注释掉了,若是tocmat是在Standalone模式下运行,而且要处理SSI和CGI请求,那么这几行注释能够去掉:
- <!--
- <servlet-mapping>
- <servlet-name>ssi</servlet-name>
- <url-pattern>*.shtml</url-pattern>
- </servlet-mapping>
- -->
- <!--
- <servlet-mapping>
- <servlet-name>cgi</servlet-name>
- <url-pattern>/cgi-bin/*</url-pattern>
- </servlet-mapping>
- -->
Session的超时配置
<session-config>标签配置tomcat6在服务器端维持一个表示客户端的session的时间,单位为分钟。
- <session-config>
- <session-timeout>30</session-timeout>
- </session-config>
MIME Mapping
- <mime-mapping>
- <extension>abs</extension>
- <mime-type>audio/x-mpeg</mime-type>
- </mime-mapping>
- <mime-mapping>
- <extension>ai</extension>
- <mime-type>application/postscript</mime-type>
- </mime-mapping>
- <mime-mapping>
- <extension>aif</extension>
- <mime-type>audio/x-aiff</mime-type>
- </mime-mapping>
- <mime-mapping>
- <extension>aifc</extension>
- <mime-type>audio/x-aiff</mime-type>
- </mime-mapping>
- ... more mime mappings...
- <mime-mapping>
- <extension>Z</extension>
- <mime-type>application/x-compress</mime-type>
- </mime-mapping>
- <mime-mapping>
- <extension>z</extension>
- <mime-type>application/x-compress</mime-type>
- </mime-mapping>
- <mime-mapping>
- <extension>zip</extension>
- <mime-type>application/zip</mime-type>
- </mime-mapping>
模拟Apache Web Server:首页定义
- <welcome-file-list>
- <welcome-file>index.html</welcome-file>
- <welcome-file>index.htm</welcome-file>
- <welcome-file>index.jsp</welcome-file>
- </welcome-file-list>
- </web-app>
catalina.policy:访问控制文件
Tomcat6使用的时内置的Java2安全模型,这个安全模型的核心思想是:
Any access to system resources that is not explicitly allowed is prohibited.
翻译过来是:除非明确受权,不然禁止访问
默认tocmat启动时是不使用这种安全策略的,除非使用这个参数启动:
> startup -security
在这个文件中,授予权限的语法通常是:
- grant <security principal> { permission list... };
- 下面是catalina.policy中的一个片断:
- // These permissions apply to javac
- grant codeBase “file:${java.home}/lib/-” {
- permission java.security.AllPermission;
- };
- // These permissions apply to all shared system extensions
- grant codeBase “file:${java.home}/jre/lib/ext/-” {
- permission java.security.AllPermission;
- };
- // These permissions apply to javac when ${java.home] points at $JAVA_HOME/jre
- grant codeBase “file:${java.home}/../lib/-” {
- permission java.security.AllPermission;
- };
- // These permissions apply to all shared system extensions when
- // ${java.home} points at $JAVA_HOME/jre
- grant codeBase “file:${java.home}/lib/ext/-” {
- permission java.security.AllPermission;
- };
这段代码赋予全部资源访问java编译器全部资源的权利
- // These permissions apply to the daemon code
- grant codeBase “file:${catalina.home}/bin/commons-daemon.jar” {
- permission java.security.AllPermission;
- };
- // These permissions apply to the logging API
- grant codeBase “file:${catalina.home}/bin/tomcat-juli.jar” {
- permission java.security.AllPermission;
- };
- // These permissions apply to the server startup code
- grant codeBase “file:${catalina.home}/bin/bootstrap.jar” {
- permission java.security.AllPermission;
- };
- // These permissions apply to the servlet API classes
- // and those that are shared across all class loaders
- // located in the “lib” directory
- grant codeBase “file:${catalina.home}/lib/-” {
- permission java.security.AllPermission;
- };
这段代码将Server code,logging code以及API库的访问权限赋予全部资源。
最后这组代码是有关web应用程序的默认权限的。与前面的不一样,这里的限制更加严格,由于它们从没有得到java.security.AllPermission受权。
第一部分是有关JDBC和JNDI的
- grant {
- // Required for JNDI lookup of named JDBC DataSource’s and
- // javamail named MimePart DataSource used to send mail
- permission java.util.PropertyPermission “java.home”, “read”;
- permission java.util.PropertyPermission “java.naming.*”, “read”;
- permission java.util.PropertyPermission “javax.sql.*”, “read”;
第二部分是授予对操做系统信息的读权限
/
- / OS Specific properties to allow read access
- permission java.util.PropertyPermission “os.name”, “read”;
- permission java.util.PropertyPermission “os.version”, “read”;
- permission java.util.PropertyPermission “os.arch”, “read”;
- permission java.util.PropertyPermission “file.separator”, “read”;
- permission java.util.PropertyPermission “path.separator”, “read”;
- permission java.util.PropertyPermission “line.separator”, “read”;
第三部分代码赋予对一些JVM相关属性的读权限
- // JVM properties to allow read access
- permission java.util.PropertyPermission “java.version”, “read”;
- permission java.util.PropertyPermission “java.vendor”, “read”;
- permission java.util.PropertyPermission “java.vendor.url”, “read”;
- permission java.util.PropertyPermission “java.class.version”, “read”;
- permission java.util.PropertyPermission “java.specification.version”,
- “read”;
- permission java.util.PropertyPermission “java.specification.vendor”,
- “read”;
- permission java.util.PropertyPermission “java.specification.name”, “read”;
- permission java.util.PropertyPermission “java.vm.specification.version”,
- “read”;
- permission java.util.PropertyPermission “java.vm.specification.vendor”,
- “read”;
- permission java.util.PropertyPermission “java.vm.specification.name”,
- “read”;
- permission java.util.PropertyPermission “java.vm.version”, “read”;
- permission java.util.PropertyPermission “java.vm.vendor”, “read”;
- permission java.util.PropertyPermission “java.vm.name”, “read”;
第四部分是有关JMX的
- // Required for OpenJMX
- permission java.lang.RuntimePermission “getAttribute”;
最后这两部分是有关XML parser和预编译JSP的,在编码阶段常用
- permission java.util.PropertyPermission “jaxp.debug”, “read”;
- permission java.lang.RuntimePermission
- “accessClassInPackage.org.apache.jasper.runtime”;
- permission java.lang.RuntimePermission
- “accessClassInPackage.org.apache.jasper.runtime.*”;};
catalina.properties:更好的访问控制
tocmat以安全模式启动时,最后加载的一个文件就是catalina.properties,这个文件容许管理员在java package(java 包)一级上进行权限控制。当有非法请求到达时,java package这一级的控制能够抛出SecurityException异常。
在catalina.properties中的这几行代码定义了限制访问的包:
- package.access=sun.,org.apache.catalina.,org.apache.coyote.,org.apache.tomcat.,
- org.apache.jasper.,sun.beans.
- package.definition=sun.,java.,org.apache.catalina.,org.apache.coyote.,
- org.apache.tomcat.,org.apache.jasper.
这几行定义了comon,server和shared的类加载器的路径:
- common.loader=${catalina.home}/lib,${catalina.home}/lib/*.jar
- server.loader=
- shared.loader=
catalina.properties的最后一行开启了string cache的使用。这个cache将在ByteChunk.toString()和CharChunk.toString()方法中使用
tomcat.util.buf.StringCache.byte.enabled=true
配置(Configuration)和管理(management)的不一样
简单地说,配置是在Tomcat启动以前进行的,而管理则是在Tomcat运行过程当中进行的。