blob: c81128c5e1a4d2ca22ee9f15492d87775894b369 [file] [log] [blame]
michaelm5ac8c152012-03-06 20:34:38 +00001#
2# This is the "master security properties file".
3#
mullan68000592012-07-03 14:56:58 -04004# An alternate java.security properties file may be specified
5# from the command line via the system property
6#
7# -Djava.security.properties=<URL>
8#
9# This properties file appends to the master security properties file.
10# If both properties files specify values for the same key, the value
11# from the command-line properties file is selected, as it is the last
12# one loaded.
13#
14# Also, if you specify
15#
16# -Djava.security.properties==<URL> (2 equals),
17#
18# then that properties file completely overrides the master security
19# properties file.
20#
21# To disable the ability to specify an additional properties file from
22# the command line, set the key security.overridePropertiesFile
23# to false in the master security properties file. It is set to true
24# by default.
25
michaelm5ac8c152012-03-06 20:34:38 +000026# In this file, various security properties are set for use by
27# java.security classes. This is where users can statically register
28# Cryptography Package Providers ("providers" for short). The term
29# "provider" refers to a package or set of packages that supply a
30# concrete implementation of a subset of the cryptography aspects of
31# the Java Security API. A provider may, for example, implement one or
32# more digital signature algorithms or message digest algorithms.
33#
34# Each provider must implement a subclass of the Provider class.
35# To register a provider in this master security properties file,
36# specify the Provider subclass name and priority in the format
37#
38# security.provider.<n>=<className>
39#
40# This declares a provider, and specifies its preference
41# order n. The preference order is the order in which providers are
42# searched for requested algorithms (when no specific provider is
43# requested). The order is 1-based; 1 is the most preferred, followed
44# by 2, and so on.
45#
46# <className> must specify the subclass of the Provider class whose
47# constructor sets the values of various properties that are required
48# for the Java Security API to look up the algorithms or other
49# facilities implemented by the provider.
50#
51# There must be at least one provider specification in java.security.
52# There is a default provider that comes standard with the JDK. It
53# is called the "SUN" provider, and its Provider subclass
54# named Sun appears in the sun.security.provider package. Thus, the
55# "SUN" provider is registered via the following:
56#
57# security.provider.1=sun.security.provider.Sun
58#
59# (The number 1 is used for the default provider.)
60#
61# Note: Providers can be dynamically registered instead by calls to
62# either the addProvider or insertProviderAt method in the Security
63# class.
64
65#
66# List of providers and their preference orders (see above):
67#
68security.provider.1=sun.security.provider.Sun
69security.provider.2=sun.security.rsa.SunRsaSign
70security.provider.3=sun.security.ec.SunEC
71security.provider.4=com.sun.net.ssl.internal.ssl.Provider
72security.provider.5=com.sun.crypto.provider.SunJCE
73security.provider.6=sun.security.jgss.SunProvider
74security.provider.7=com.sun.security.sasl.Provider
75security.provider.8=org.jcp.xml.dsig.internal.dom.XMLDSigRI
76security.provider.9=sun.security.smartcardio.SunPCSC
77security.provider.10=apple.security.AppleProvider
78
79#
80# Select the source of seed data for SecureRandom. By default an
81# attempt is made to use the entropy gathering device specified by
82# the securerandom.source property. If an exception occurs when
83# accessing the URL then the traditional system/thread activity
84# algorithm is used.
85#
86# On Solaris and Linux systems, if file:/dev/urandom is specified and it
87# exists, a special SecureRandom implementation is activated by default.
88# This "NativePRNG" reads random bytes directly from /dev/urandom.
89#
90# On Windows systems, the URLs file:/dev/random and file:/dev/urandom
91# enables use of the Microsoft CryptoAPI seed functionality.
92#
93securerandom.source=file:/dev/urandom
94#
95# The entropy gathering device is described as a URL and can also
96# be specified with the system property "java.security.egd". For example,
97# -Djava.security.egd=file:/dev/urandom
98# Specifying this system property will override the securerandom.source
99# setting.
100
101#
102# Class to instantiate as the javax.security.auth.login.Configuration
103# provider.
104#
105login.configuration.provider=com.sun.security.auth.login.ConfigFile
106
107#
108# Default login configuration file
109#
110#login.config.url.1=file:${user.home}/.java.login.config
111
112#
113# Class to instantiate as the system Policy. This is the name of the class
114# that will be used as the Policy object.
115#
116policy.provider=sun.security.provider.PolicyFile
117
118# The default is to have a single system-wide policy file,
119# and a policy file in the user's home directory.
120policy.url.1=file:${java.home}/lib/security/java.policy
121policy.url.2=file:${user.home}/.java.policy
122
123# whether or not we expand properties in the policy file
124# if this is set to false, properties (${...}) will not be expanded in policy
125# files.
126policy.expandProperties=true
127
128# whether or not we allow an extra policy to be passed on the command line
129# with -Djava.security.policy=somefile. Comment out this line to disable
130# this feature.
131policy.allowSystemProperty=true
132
133# whether or not we look into the IdentityScope for trusted Identities
134# when encountering a 1.1 signed JAR file. If the identity is found
135# and is trusted, we grant it AllPermission.
136policy.ignoreIdentityScope=false
137
138#
139# Default keystore type.
140#
141keystore.type=jks
142
143#
144# List of comma-separated packages that start with or equal this string
145# will cause a security exception to be thrown when
146# passed to checkPackageAccess unless the
147# corresponding RuntimePermission ("accessClassInPackage."+package) has
148# been granted.
mullan54257132012-10-26 15:21:05 -0400149package.access=sun.,\
mullan67d29c92012-12-18 13:48:48 -0500150 com.sun.xml.internal.bind.,\
151 com.sun.xml.internal.org.jvnet.staxex.,\
152 com.sun.xml.internal.ws.,\
mullan54257132012-10-26 15:21:05 -0400153 com.sun.imageio.,\
mchung60367132012-12-05 14:02:58 -0800154 com.sun.istack.internal.,\
dfuchs0fe8bdd2013-01-30 11:33:51 +0100155 com.sun.jmx.,\
mchung1cdf5492013-01-28 15:53:29 -0800156 com.sun.proxy.,\
mullan54257132012-10-26 15:21:05 -0400157 com.sun.org.apache.xerces.internal.utils.,\
158 com.sun.org.apache.xalan.internal.utils.,\
159 com.sun.org.glassfish.external.,\
160 com.sun.org.glassfish.gmbal.,\
alanba3151942013-04-09 15:51:50 +0100161 com.oracle.xmlns.internal.,\
162 com.oracle.webservices.internal.,\
ewendeli69845692013-01-28 11:07:07 +0100163 jdk.internal.,\
sundar2fea0d82013-03-21 19:19:08 +0530164 jdk.nashorn.internal.,\
165 jdk.nashorn.tools.,\
mullan54257132012-10-26 15:21:05 -0400166 apple.
michaelm5ac8c152012-03-06 20:34:38 +0000167
168#
169# List of comma-separated packages that start with or equal this string
170# will cause a security exception to be thrown when
171# passed to checkPackageDefinition unless the
172# corresponding RuntimePermission ("defineClassInPackage."+package) has
173# been granted.
174#
asahace776df2012-05-24 10:23:21 -0700175# by default, none of the class loaders supplied with the JDK call
176# checkPackageDefinition.
michaelm5ac8c152012-03-06 20:34:38 +0000177#
mullan54257132012-10-26 15:21:05 -0400178package.definition=sun.,\
mullan67d29c92012-12-18 13:48:48 -0500179 com.sun.xml.internal.bind.,\
180 com.sun.xml.internal.org.jvnet.staxex.,\
181 com.sun.xml.internal.ws.,\
mullan54257132012-10-26 15:21:05 -0400182 com.sun.imageio.,\
mchung60367132012-12-05 14:02:58 -0800183 com.sun.istack.internal.,\
dfuchs0fe8bdd2013-01-30 11:33:51 +0100184 com.sun.jmx.,\
mchung1cdf5492013-01-28 15:53:29 -0800185 com.sun.proxy.,\
mullan54257132012-10-26 15:21:05 -0400186 com.sun.org.apache.xerces.internal.utils.,\
187 com.sun.org.apache.xalan.internal.utils.,\
188 com.sun.org.glassfish.external.,\
189 com.sun.org.glassfish.gmbal.,\
alanba3151942013-04-09 15:51:50 +0100190 com.oracle.xmlns.internal.,\
191 com.oracle.webservices.internal.,\
ewendeli69845692013-01-28 11:07:07 +0100192 jdk.internal.,\
sundar2fea0d82013-03-21 19:19:08 +0530193 jdk.nashorn.internal.,\
194 jdk.nashorn.tools.,\
mullan54257132012-10-26 15:21:05 -0400195 apple.
michaelm5ac8c152012-03-06 20:34:38 +0000196
197#
198# Determines whether this properties file can be appended to
199# or overridden on the command line via -Djava.security.properties
200#
201security.overridePropertiesFile=true
202
203#
204# Determines the default key and trust manager factory algorithms for
205# the javax.net.ssl package.
206#
207ssl.KeyManagerFactory.algorithm=SunX509
208ssl.TrustManagerFactory.algorithm=PKIX
209
210#
211# The Java-level namelookup cache policy for successful lookups:
212#
213# any negative value: caching forever
214# any positive value: the number of seconds to cache an address for
215# zero: do not cache
216#
217# default value is forever (FOREVER). For security reasons, this
218# caching is made forever when a security manager is set. When a security
219# manager is not set, the default behavior in this implementation
220# is to cache for 30 seconds.
221#
222# NOTE: setting this to anything other than the default value can have
223# serious security implications. Do not set it unless
224# you are sure you are not exposed to DNS spoofing attack.
225#
226#networkaddress.cache.ttl=-1
227
228# The Java-level namelookup cache policy for failed lookups:
229#
230# any negative value: cache forever
231# any positive value: the number of seconds to cache negative lookup results
232# zero: do not cache
233#
234# In some Microsoft Windows networking environments that employ
235# the WINS name service in addition to DNS, name service lookups
236# that fail may take a noticeably long time to return (approx. 5 seconds).
237# For this reason the default caching policy is to maintain these
238# results for 10 seconds.
239#
240#
241networkaddress.cache.negative.ttl=10
242
243#
244# Properties to configure OCSP for certificate revocation checking
245#
246
247# Enable OCSP
248#
249# By default, OCSP is not used for certificate revocation checking.
250# This property enables the use of OCSP when set to the value "true".
251#
252# NOTE: SocketPermission is required to connect to an OCSP responder.
253#
254# Example,
255# ocsp.enable=true
256
257#
258# Location of the OCSP responder
259#
260# By default, the location of the OCSP responder is determined implicitly
261# from the certificate being validated. This property explicitly specifies
262# the location of the OCSP responder. The property is used when the
263# Authority Information Access extension (defined in RFC 3280) is absent
264# from the certificate or when it requires overriding.
265#
266# Example,
267# ocsp.responderURL=http://ocsp.example.net:80
268
269#
270# Subject name of the OCSP responder's certificate
271#
272# By default, the certificate of the OCSP responder is that of the issuer
273# of the certificate being validated. This property identifies the certificate
274# of the OCSP responder when the default does not apply. Its value is a string
275# distinguished name (defined in RFC 2253) which identifies a certificate in
276# the set of certificates supplied during cert path validation. In cases where
277# the subject name alone is not sufficient to uniquely identify the certificate
278# then both the "ocsp.responderCertIssuerName" and
279# "ocsp.responderCertSerialNumber" properties must be used instead. When this
280# property is set then those two properties are ignored.
281#
282# Example,
283# ocsp.responderCertSubjectName="CN=OCSP Responder, O=XYZ Corp"
284
285#
286# Issuer name of the OCSP responder's certificate
287#
288# By default, the certificate of the OCSP responder is that of the issuer
289# of the certificate being validated. This property identifies the certificate
290# of the OCSP responder when the default does not apply. Its value is a string
291# distinguished name (defined in RFC 2253) which identifies a certificate in
292# the set of certificates supplied during cert path validation. When this
293# property is set then the "ocsp.responderCertSerialNumber" property must also
294# be set. When the "ocsp.responderCertSubjectName" property is set then this
295# property is ignored.
296#
297# Example,
298# ocsp.responderCertIssuerName="CN=Enterprise CA, O=XYZ Corp"
299
300#
301# Serial number of the OCSP responder's certificate
302#
303# By default, the certificate of the OCSP responder is that of the issuer
304# of the certificate being validated. This property identifies the certificate
305# of the OCSP responder when the default does not apply. Its value is a string
306# of hexadecimal digits (colon or space separators may be present) which
307# identifies a certificate in the set of certificates supplied during cert path
308# validation. When this property is set then the "ocsp.responderCertIssuerName"
309# property must also be set. When the "ocsp.responderCertSubjectName" property
310# is set then this property is ignored.
311#
312# Example,
313# ocsp.responderCertSerialNumber=2A:FF:00
314
315#
316# Policy for failed Kerberos KDC lookups:
317#
318# When a KDC is unavailable (network error, service failure, etc), it is
319# put inside a blacklist and accessed less often for future requests. The
320# value (case-insensitive) for this policy can be:
321#
322# tryLast
323# KDCs in the blacklist are always tried after those not on the list.
324#
325# tryLess[:max_retries,timeout]
326# KDCs in the blacklist are still tried by their order in the configuration,
327# but with smaller max_retries and timeout values. max_retries and timeout
328# are optional numerical parameters (default 1 and 5000, which means once
329# and 5 seconds). Please notes that if any of the values defined here is
330# more than what is defined in krb5.conf, it will be ignored.
331#
332# Whenever a KDC is detected as available, it is removed from the blacklist.
333# The blacklist is reset when krb5.conf is reloaded. You can add
334# refreshKrb5Config=true to a JAAS configuration file so that krb5.conf is
335# reloaded whenever a JAAS authentication is attempted.
336#
337# Example,
338# krb5.kdc.bad.policy = tryLast
339# krb5.kdc.bad.policy = tryLess:2,2000
340krb5.kdc.bad.policy = tryLast
341
342# Algorithm restrictions for certification path (CertPath) processing
343#
344# In some environments, certain algorithms or key lengths may be undesirable
345# for certification path building and validation. For example, "MD2" is
346# generally no longer considered to be a secure hash algorithm. This section
347# describes the mechanism for disabling algorithms based on algorithm name
348# and/or key length. This includes algorithms used in certificates, as well
349# as revocation information such as CRLs and signed OCSP Responses.
350#
351# The syntax of the disabled algorithm string is described as this Java
352# BNF-style:
353# DisabledAlgorithms:
354# " DisabledAlgorithm { , DisabledAlgorithm } "
355#
356# DisabledAlgorithm:
357# AlgorithmName [Constraint]
358#
359# AlgorithmName:
360# (see below)
361#
362# Constraint:
363# KeySizeConstraint
364#
365# KeySizeConstraint:
366# keySize Operator DecimalInteger
367#
368# Operator:
369# <= | < | == | != | >= | >
370#
371# DecimalInteger:
372# DecimalDigits
373#
374# DecimalDigits:
375# DecimalDigit {DecimalDigit}
376#
377# DecimalDigit: one of
378# 1 2 3 4 5 6 7 8 9 0
379#
380# The "AlgorithmName" is the standard algorithm name of the disabled
381# algorithm. See "Java Cryptography Architecture Standard Algorithm Name
382# Documentation" for information about Standard Algorithm Names. Matching
383# is performed using a case-insensitive sub-element matching rule. (For
384# example, in "SHA1withECDSA" the sub-elements are "SHA1" for hashing and
385# "ECDSA" for signatures.) If the assertion "AlgorithmName" is a
386# sub-element of the certificate algorithm name, the algorithm will be
387# rejected during certification path building and validation. For example,
388# the assertion algorithm name "DSA" will disable all certificate algorithms
389# that rely on DSA, such as NONEwithDSA, SHA1withDSA. However, the assertion
390# will not disable algorithms related to "ECDSA".
391#
392# A "Constraint" provides further guidance for the algorithm being specified.
393# The "KeySizeConstraint" requires a key of a valid size range if the
394# "AlgorithmName" is of a key algorithm. The "DecimalInteger" indicates the
395# key size specified in number of bits. For example, "RSA keySize <= 1024"
396# indicates that any RSA key with key size less than or equal to 1024 bits
397# should be disabled, and "RSA keySize < 1024, RSA keySize > 2048" indicates
398# that any RSA key with key size less than 1024 or greater than 2048 should
399# be disabled. Note that the "KeySizeConstraint" only makes sense to key
400# algorithms.
401#
402# Note: This property is currently used by Oracle's PKIX implementation. It
403# is not guaranteed to be examined and used by other implementations.
404#
405# Example:
406# jdk.certpath.disabledAlgorithms=MD2, DSA, RSA keySize < 2048
407#
408#
xuelei7b2dfe72012-12-28 00:48:12 -0800409jdk.certpath.disabledAlgorithms=MD2, RSA keySize < 1024
michaelm5ac8c152012-03-06 20:34:38 +0000410
411# Algorithm restrictions for Secure Socket Layer/Transport Layer Security
412# (SSL/TLS) processing
413#
414# In some environments, certain algorithms or key lengths may be undesirable
415# when using SSL/TLS. This section describes the mechanism for disabling
416# algorithms during SSL/TLS security parameters negotiation, including cipher
417# suites selection, peer authentication and key exchange mechanisms.
418#
419# For PKI-based peer authentication and key exchange mechanisms, this list
420# of disabled algorithms will also be checked during certification path
421# building and validation, including algorithms used in certificates, as
422# well as revocation information such as CRLs and signed OCSP Responses.
423# This is in addition to the jdk.certpath.disabledAlgorithms property above.
424#
425# See the specification of "jdk.certpath.disabledAlgorithms" for the
426# syntax of the disabled algorithm string.
427#
428# Note: This property is currently used by Oracle's JSSE implementation.
429# It is not guaranteed to be examined and used by other implementations.
430#
431# Example:
432# jdk.tls.disabledAlgorithms=MD5, SHA1, DSA, RSA keySize < 2048
433