1 // Licensed to the Apache Software Foundation (ASF) under one or more
2 // contributor license agreements. See the NOTICE file distributed with
3 // this work for additional information regarding copyright ownership.
4 // The ASF licenses this file to You under the Apache License, Version 2.0
5 // (the "License"); you may not use this file except in compliance with
6 // the License. You may obtain a copy of the License at
8 // http://www.apache.org/licenses/LICENSE-2.0
10 // Unless required by applicable law or agreed to in writing, software
11 // distributed under the License is distributed on an "AS IS" BASIS,
12 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 // See the License for the specific language governing permissions and
14 // limitations under the License.
16 // ============================================================================
17 // catalina.policy - Security Policy Permissions for Tomcat
19 // This file contains a default set of security policies to be enforced (by the
20 // JVM) when Catalina is executed with the "-security" option. In addition
21 // to the permissions granted here, the following additional permissions are
22 // granted to each web application:
24 // * Read access to the web application's document root directory
25 // * Read, write and delete access to the web application's working directory
26 // ============================================================================
29 // ========== SYSTEM CODE PERMISSIONS =========================================
32 // These permissions apply to javac
33 grant codeBase "file:${java.home}/lib/-" {
34 permission java.security.AllPermission;
37 // These permissions apply to all shared system extensions
38 grant codeBase "file:${java.home}/jre/lib/ext/-" {
39 permission java.security.AllPermission;
42 // These permissions apply to javac when ${java.home] points at $JAVA_HOME/jre
43 grant codeBase "file:${java.home}/../lib/-" {
44 permission java.security.AllPermission;
47 // These permissions apply to all shared system extensions when
48 // ${java.home} points at $JAVA_HOME/jre
49 grant codeBase "file:${java.home}/lib/ext/-" {
50 permission java.security.AllPermission;
54 // ========== CATALINA CODE PERMISSIONS =======================================
57 // These permissions apply to the daemon code
58 grant codeBase "file:${catalina.home}/bin/commons-daemon.jar" {
59 permission java.security.AllPermission;
62 // These permissions apply to the logging API
63 // Note: If tomcat-juli.jar is in ${catalina.base} and not in ${catalina.home},
64 // update this section accordingly.
65 // grant codeBase "file:${catalina.base}/bin/tomcat-juli.jar" {..}
66 grant codeBase "file:${catalina.home}/bin/tomcat-juli.jar" {
67 permission java.io.FilePermission
68 "${java.home}${file.separator}lib${file.separator}logging.properties", "read";
70 permission java.io.FilePermission
71 "${catalina.base}${file.separator}conf${file.separator}logging.properties", "read";
72 permission java.io.FilePermission
73 "${catalina.base}${file.separator}logs", "read, write";
74 permission java.io.FilePermission
75 "${catalina.base}${file.separator}logs${file.separator}*", "read, write";
77 permission java.lang.RuntimePermission "shutdownHooks";
78 permission java.lang.RuntimePermission "getClassLoader";
79 permission java.lang.RuntimePermission "setContextClassLoader";
81 permission java.lang.management.ManagementPermission "monitor";
83 permission java.util.logging.LoggingPermission "control";
85 permission java.util.PropertyPermission "java.util.logging.config.class", "read";
86 permission java.util.PropertyPermission "java.util.logging.config.file", "read";
87 permission java.util.PropertyPermission "org.apache.juli.AsyncLoggerPollInterval", "read";
88 permission java.util.PropertyPermission "org.apache.juli.AsyncMaxRecordCount", "read";
89 permission java.util.PropertyPermission "org.apache.juli.AsyncOverflowDropType", "read";
90 permission java.util.PropertyPermission "org.apache.juli.ClassLoaderLogManager.debug", "read";
91 permission java.util.PropertyPermission "catalina.base", "read";
93 // Note: To enable per context logging configuration, permit read access to
94 // the appropriate file. Be sure that the logging configuration is
95 // secure before enabling such access.
96 // E.g. for the examples web application (uncomment and unwrap
97 // the following to be on a single line):
98 // permission java.io.FilePermission "${catalina.base}${file.separator}
99 // webapps${file.separator}examples${file.separator}WEB-INF
100 // ${file.separator}classes${file.separator}logging.properties", "read";
103 // These permissions apply to the server startup code
104 grant codeBase "file:${catalina.home}/bin/bootstrap.jar" {
105 permission java.security.AllPermission;
108 // These permissions apply to the servlet API classes
109 // and those that are shared across all class loaders
110 // located in the "lib" directory
111 grant codeBase "file:${catalina.home}/lib/-" {
112 permission java.security.AllPermission;
116 // If using a per instance lib directory, i.e. ${catalina.base}/lib,
117 // then the following permission will need to be uncommented
118 // grant codeBase "file:${catalina.base}/lib/-" {
119 // permission java.security.AllPermission;
123 // ========== WEB APPLICATION PERMISSIONS =====================================
126 // These permissions are granted by default to all web applications
127 // In addition, a web application will be given a read FilePermission
128 // for all files and directories in its document root.
130 // Required for JNDI lookup of named JDBC DataSource's and
131 // javamail named MimePart DataSource used to send mail
132 permission java.util.PropertyPermission "java.home", "read";
133 permission java.util.PropertyPermission "java.naming.*", "read";
134 permission java.util.PropertyPermission "javax.sql.*", "read";
136 // OS Specific properties to allow read access
137 permission java.util.PropertyPermission "os.name", "read";
138 permission java.util.PropertyPermission "os.version", "read";
139 permission java.util.PropertyPermission "os.arch", "read";
140 permission java.util.PropertyPermission "file.separator", "read";
141 permission java.util.PropertyPermission "path.separator", "read";
142 permission java.util.PropertyPermission "line.separator", "read";
144 // JVM properties to allow read access
145 permission java.util.PropertyPermission "java.version", "read";
146 permission java.util.PropertyPermission "java.vendor", "read";
147 permission java.util.PropertyPermission "java.vendor.url", "read";
148 permission java.util.PropertyPermission "java.class.version", "read";
149 permission java.util.PropertyPermission "java.specification.version", "read";
150 permission java.util.PropertyPermission "java.specification.vendor", "read";
151 permission java.util.PropertyPermission "java.specification.name", "read";
153 permission java.util.PropertyPermission "java.vm.specification.version", "read";
154 permission java.util.PropertyPermission "java.vm.specification.vendor", "read";
155 permission java.util.PropertyPermission "java.vm.specification.name", "read";
156 permission java.util.PropertyPermission "java.vm.version", "read";
157 permission java.util.PropertyPermission "java.vm.vendor", "read";
158 permission java.util.PropertyPermission "java.vm.name", "read";
160 // Required for OpenJMX
161 permission java.lang.RuntimePermission "getAttribute";
163 // Allow read of JAXP compliant XML parser debug
164 permission java.util.PropertyPermission "jaxp.debug", "read";
166 // All JSPs need to be able to read this package
167 permission java.lang.RuntimePermission "accessClassInPackage.org.apache.tomcat";
169 // Precompiled JSPs need access to these packages.
170 permission java.lang.RuntimePermission "accessClassInPackage.org.apache.jasper.el";
171 permission java.lang.RuntimePermission "accessClassInPackage.org.apache.jasper.runtime";
172 permission java.lang.RuntimePermission
173 "accessClassInPackage.org.apache.jasper.runtime.*";
175 // Precompiled JSPs need access to these system properties.
176 permission java.util.PropertyPermission
177 "org.apache.jasper.runtime.BodyContentImpl.LIMIT_BUFFER", "read";
178 permission java.util.PropertyPermission
179 "org.apache.el.parser.COERCE_TO_ZERO", "read";
181 // The cookie code needs these.
182 permission java.util.PropertyPermission
183 "org.apache.catalina.STRICT_SERVLET_COMPLIANCE", "read";
184 permission java.util.PropertyPermission
185 "org.apache.tomcat.util.http.ServerCookie.STRICT_NAMING", "read";
186 permission java.util.PropertyPermission
187 "org.apache.tomcat.util.http.ServerCookie.FWD_SLASH_IS_SEPARATOR", "read";
189 // Applications using Comet need to be able to access this package
190 permission java.lang.RuntimePermission "accessClassInPackage.org.apache.catalina.comet";
192 // Applications using WebSocket need to be able to access these packages
193 permission java.lang.RuntimePermission "accessClassInPackage.org.apache.tomcat.websocket";
194 permission java.lang.RuntimePermission "accessClassInPackage.org.apache.tomcat.websocket.server";
198 // The Manager application needs access to the following packages to support the
199 // session display functionality. These settings support the following
201 // - default CATALINA_HOME == CATALINA_BASE
202 // - CATALINA_HOME != CATALINA_BASE, per instance Manager in CATALINA_BASE
203 // - CATALINA_HOME != CATALINA_BASE, shared Manager in CATALINA_HOME
204 grant codeBase "file:${catalina.base}/webapps/manager/-" {
205 permission java.lang.RuntimePermission "accessClassInPackage.org.apache.catalina";
206 permission java.lang.RuntimePermission "accessClassInPackage.org.apache.catalina.ha.session";
207 permission java.lang.RuntimePermission "accessClassInPackage.org.apache.catalina.manager";
208 permission java.lang.RuntimePermission "accessClassInPackage.org.apache.catalina.manager.util";
209 permission java.lang.RuntimePermission "accessClassInPackage.org.apache.catalina.util";
211 grant codeBase "file:${catalina.home}/webapps/manager/-" {
212 permission java.lang.RuntimePermission "accessClassInPackage.org.apache.catalina";
213 permission java.lang.RuntimePermission "accessClassInPackage.org.apache.catalina.ha.session";
214 permission java.lang.RuntimePermission "accessClassInPackage.org.apache.catalina.manager";
215 permission java.lang.RuntimePermission "accessClassInPackage.org.apache.catalina.manager.util";
216 permission java.lang.RuntimePermission "accessClassInPackage.org.apache.catalina.util";
219 // You can assign additional permissions to particular web applications by
220 // adding additional "grant" entries here, based on the code base for that
221 // application, /WEB-INF/classes/, or /WEB-INF/lib/ jar files.
223 // Different permissions can be granted to JSP pages, classes loaded from
224 // the /WEB-INF/classes/ directory, all jar files in the /WEB-INF/lib/
225 // directory, or even to individual jar files in the /WEB-INF/lib/ directory.
227 // For instance, assume that the standard "examples" application
228 // included a JDBC driver that needed to establish a network connection to the
229 // corresponding database and used the scrape taglib to get the weather from
230 // the NOAA web server. You might create a "grant" entries like this:
232 // The permissions granted to the context root directory apply to JSP pages.
233 // grant codeBase "file:${catalina.base}/webapps/examples/-" {
234 // permission java.net.SocketPermission "dbhost.mycompany.com:5432", "connect";
235 // permission java.net.SocketPermission "*.noaa.gov:80", "connect";
238 // The permissions granted to the context WEB-INF/classes directory
239 // grant codeBase "file:${catalina.base}/webapps/examples/WEB-INF/classes/-" {
242 // The permission granted to your JDBC driver
243 // grant codeBase "jar:file:${catalina.base}/webapps/examples/WEB-INF/lib/driver.jar!/-" {
244 // permission java.net.SocketPermission "dbhost.mycompany.com:5432", "connect";
246 // The permission granted to the scrape taglib
247 // grant codeBase "jar:file:${catalina.base}/webapps/examples/WEB-INF/lib/scrape.jar!/-" {
248 // permission java.net.SocketPermission "*.noaa.gov:80", "connect";