blob: f26efb05284f866e3484ca45874b2f6384f8ac95 [file] [log] [blame]
duke6e45e102007-12-01 00:00:00 +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
duke6e45e102007-12-01 00:00:00 +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
vinnieed355ab2009-08-11 16:52:26 +010070security.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
duke6e45e102007-12-01 00:00:00 +000077
78#
wetmore5f58e202013-04-11 21:03:24 -070079# Sun Provider SecureRandom seed source.
duke6e45e102007-12-01 00:00:00 +000080#
wetmore5f58e202013-04-11 21:03:24 -070081# Select the primary source of seed data for the "SHA1PRNG" and
82# "NativePRNG" SecureRandom implementations in the "Sun" provider.
83# (Other SecureRandom implementations might also use this property.)
duke6e45e102007-12-01 00:00:00 +000084#
wetmore5f58e202013-04-11 21:03:24 -070085# On Unix-like systems (for example, Solaris/Linux/MacOS), the
86# "NativePRNG" and "SHA1PRNG" implementations obtains seed data from
87# special device files such as file:/dev/random.
duke6e45e102007-12-01 00:00:00 +000088#
wetmore5f58e202013-04-11 21:03:24 -070089# On Windows systems, specifying the URLs "file:/dev/random" or
90# "file:/dev/urandom" will enable the native Microsoft CryptoAPI seeding
91# mechanism for SHA1PRNG.
duke6e45e102007-12-01 00:00:00 +000092#
wetmore5f58e202013-04-11 21:03:24 -070093# By default, an attempt is made to use the entropy gathering device
94# specified by the "securerandom.source" Security property. If an
95# exception occurs while accessing the specified URL:
96#
97# SHA1PRNG:
98# the traditional system/thread activity algorithm will be used.
99#
100# NativePRNG:
101# a default value of /dev/random will be used. If neither
102# are available, the implementation will be disabled.
103# "file" is the only currently supported protocol type.
104#
105# The entropy gathering device can also be specified with the System
106# property "java.security.egd". For example:
107#
108# % java -Djava.security.egd=file:/dev/random MainClass
109#
110# Specifying this System property will override the
111# "securerandom.source" Security property.
112#
113# In addition, if "file:/dev/random" or "file:/dev/urandom" is
114# specified, the "NativePRNG" implementation will be more preferred than
115# SHA1PRNG in the Sun provider.
116#
117securerandom.source=file:/dev/random
118
119#
120# A list of known strong SecureRandom implementations.
121#
122# To help guide applications in selecting a suitable strong
123# java.security.SecureRandom implementation, Java distributions should
124# indicate a list of known strong implementations using the property.
125#
126# This is a comma-separated list of algorithm and/or algorithm:provider
127# entries.
128#
129securerandom.strongAlgorithms=NativePRNGBlocking:SUN
duke6e45e102007-12-01 00:00:00 +0000130
131#
132# Class to instantiate as the javax.security.auth.login.Configuration
133# provider.
134#
135login.configuration.provider=com.sun.security.auth.login.ConfigFile
136
137#
138# Default login configuration file
139#
140#login.config.url.1=file:${user.home}/.java.login.config
141
142#
143# Class to instantiate as the system Policy. This is the name of the class
144# that will be used as the Policy object.
145#
146policy.provider=sun.security.provider.PolicyFile
147
148# The default is to have a single system-wide policy file,
149# and a policy file in the user's home directory.
150policy.url.1=file:${java.home}/lib/security/java.policy
151policy.url.2=file:${user.home}/.java.policy
152
153# whether or not we expand properties in the policy file
154# if this is set to false, properties (${...}) will not be expanded in policy
155# files.
156policy.expandProperties=true
157
158# whether or not we allow an extra policy to be passed on the command line
159# with -Djava.security.policy=somefile. Comment out this line to disable
160# this feature.
161policy.allowSystemProperty=true
162
163# whether or not we look into the IdentityScope for trusted Identities
164# when encountering a 1.1 signed JAR file. If the identity is found
165# and is trusted, we grant it AllPermission.
166policy.ignoreIdentityScope=false
167
168#
169# Default keystore type.
170#
171keystore.type=jks
172
173#
duke6e45e102007-12-01 00:00:00 +0000174# List of comma-separated packages that start with or equal this string
175# will cause a security exception to be thrown when
176# passed to checkPackageAccess unless the
177# corresponding RuntimePermission ("accessClassInPackage."+package) has
178# been granted.
ewendeli69845692013-01-28 11:07:07 +0100179package.access=sun.,\
180 com.sun.xml.internal.bind.,\
181 com.sun.xml.internal.org.jvnet.staxex.,\
182 com.sun.xml.internal.ws.,\
183 com.sun.imageio.,\
184 com.sun.istack.internal.,\
dfuchs0fe8bdd2013-01-30 11:33:51 +0100185 com.sun.jmx.,\
mchung1cdf5492013-01-28 15:53:29 -0800186 com.sun.proxy.,\
ewendeli69845692013-01-28 11:07:07 +0100187 com.sun.org.apache.xerces.internal.utils.,\
188 com.sun.org.apache.xalan.internal.utils.,\
189 com.sun.org.glassfish.external.,\
190 com.sun.org.glassfish.gmbal.,\
alanba3151942013-04-09 15:51:50 +0100191 com.oracle.xmlns.internal.,\
192 com.oracle.webservices.internal.,\
wetmore5f58e202013-04-11 21:03:24 -0700193 jdk.internal.,\
194 jdk.nashorn.internal.,\
195 jdk.nashorn.tools.
duke6e45e102007-12-01 00:00:00 +0000196
197#
198# List of comma-separated packages that start with or equal this string
199# will cause a security exception to be thrown when
200# passed to checkPackageDefinition unless the
201# corresponding RuntimePermission ("defineClassInPackage."+package) has
202# been granted.
203#
mullanee9229d2012-02-22 15:38:24 -0500204# by default, none of the class loaders supplied with the JDK call
205# checkPackageDefinition.
duke6e45e102007-12-01 00:00:00 +0000206#
ewendeli69845692013-01-28 11:07:07 +0100207package.definition=sun.,\
208 com.sun.xml.internal.bind.,\
209 com.sun.xml.internal.org.jvnet.staxex.,\
210 com.sun.xml.internal.ws.,\
211 com.sun.imageio.,\
212 com.sun.istack.internal.,\
dfuchs0fe8bdd2013-01-30 11:33:51 +0100213 com.sun.jmx.,\
mchung1cdf5492013-01-28 15:53:29 -0800214 com.sun.proxy.,\
ewendeli69845692013-01-28 11:07:07 +0100215 com.sun.org.apache.xerces.internal.utils.,\
216 com.sun.org.apache.xalan.internal.utils.,\
217 com.sun.org.glassfish.external.,\
218 com.sun.org.glassfish.gmbal.,\
alanba3151942013-04-09 15:51:50 +0100219 com.oracle.xmlns.internal.,\
220 com.oracle.webservices.internal.,\
wetmore5f58e202013-04-11 21:03:24 -0700221 jdk.internal.,\
222 jdk.nashorn.internal.,\
223 jdk.nashorn.tools.
duke6e45e102007-12-01 00:00:00 +0000224
225#
226# Determines whether this properties file can be appended to
227# or overridden on the command line via -Djava.security.properties
228#
229security.overridePropertiesFile=true
230
231#
weijun0f0fb6a2009-12-24 13:56:19 +0800232# Determines the default key and trust manager factory algorithms for
duke6e45e102007-12-01 00:00:00 +0000233# the javax.net.ssl package.
234#
235ssl.KeyManagerFactory.algorithm=SunX509
236ssl.TrustManagerFactory.algorithm=PKIX
237
238#
239# The Java-level namelookup cache policy for successful lookups:
240#
241# any negative value: caching forever
242# any positive value: the number of seconds to cache an address for
243# zero: do not cache
244#
245# default value is forever (FOREVER). For security reasons, this
246# caching is made forever when a security manager is set. When a security
247# manager is not set, the default behavior in this implementation
248# is to cache for 30 seconds.
249#
250# NOTE: setting this to anything other than the default value can have
weijun0f0fb6a2009-12-24 13:56:19 +0800251# serious security implications. Do not set it unless
duke6e45e102007-12-01 00:00:00 +0000252# you are sure you are not exposed to DNS spoofing attack.
253#
weijun0f0fb6a2009-12-24 13:56:19 +0800254#networkaddress.cache.ttl=-1
duke6e45e102007-12-01 00:00:00 +0000255
256# The Java-level namelookup cache policy for failed lookups:
257#
258# any negative value: cache forever
259# any positive value: the number of seconds to cache negative lookup results
260# zero: do not cache
261#
262# In some Microsoft Windows networking environments that employ
263# the WINS name service in addition to DNS, name service lookups
264# that fail may take a noticeably long time to return (approx. 5 seconds).
265# For this reason the default caching policy is to maintain these
weijun0f0fb6a2009-12-24 13:56:19 +0800266# results for 10 seconds.
duke6e45e102007-12-01 00:00:00 +0000267#
268#
269networkaddress.cache.negative.ttl=10
270
271#
272# Properties to configure OCSP for certificate revocation checking
273#
274
weijun0f0fb6a2009-12-24 13:56:19 +0800275# Enable OCSP
duke6e45e102007-12-01 00:00:00 +0000276#
277# By default, OCSP is not used for certificate revocation checking.
278# This property enables the use of OCSP when set to the value "true".
279#
280# NOTE: SocketPermission is required to connect to an OCSP responder.
281#
282# Example,
283# ocsp.enable=true
weijun0f0fb6a2009-12-24 13:56:19 +0800284
duke6e45e102007-12-01 00:00:00 +0000285#
286# Location of the OCSP responder
287#
288# By default, the location of the OCSP responder is determined implicitly
289# from the certificate being validated. This property explicitly specifies
290# the location of the OCSP responder. The property is used when the
291# Authority Information Access extension (defined in RFC 3280) is absent
292# from the certificate or when it requires overriding.
293#
294# Example,
295# ocsp.responderURL=http://ocsp.example.net:80
weijun0f0fb6a2009-12-24 13:56:19 +0800296
duke6e45e102007-12-01 00:00:00 +0000297#
298# Subject name of the OCSP responder's certificate
299#
300# By default, the certificate of the OCSP responder is that of the issuer
301# of the certificate being validated. This property identifies the certificate
weijun0f0fb6a2009-12-24 13:56:19 +0800302# of the OCSP responder when the default does not apply. Its value is a string
303# distinguished name (defined in RFC 2253) which identifies a certificate in
304# the set of certificates supplied during cert path validation. In cases where
duke6e45e102007-12-01 00:00:00 +0000305# the subject name alone is not sufficient to uniquely identify the certificate
306# then both the "ocsp.responderCertIssuerName" and
307# "ocsp.responderCertSerialNumber" properties must be used instead. When this
308# property is set then those two properties are ignored.
309#
310# Example,
311# ocsp.responderCertSubjectName="CN=OCSP Responder, O=XYZ Corp"
312
313#
314# Issuer name of the OCSP responder's certificate
315#
316# By default, the certificate of the OCSP responder is that of the issuer
317# of the certificate being validated. This property identifies the certificate
318# of the OCSP responder when the default does not apply. Its value is a string
319# distinguished name (defined in RFC 2253) which identifies a certificate in
weijun0f0fb6a2009-12-24 13:56:19 +0800320# the set of certificates supplied during cert path validation. When this
321# property is set then the "ocsp.responderCertSerialNumber" property must also
322# be set. When the "ocsp.responderCertSubjectName" property is set then this
duke6e45e102007-12-01 00:00:00 +0000323# property is ignored.
324#
325# Example,
326# ocsp.responderCertIssuerName="CN=Enterprise CA, O=XYZ Corp"
weijun0f0fb6a2009-12-24 13:56:19 +0800327
duke6e45e102007-12-01 00:00:00 +0000328#
329# Serial number of the OCSP responder's certificate
330#
331# By default, the certificate of the OCSP responder is that of the issuer
332# of the certificate being validated. This property identifies the certificate
333# of the OCSP responder when the default does not apply. Its value is a string
334# of hexadecimal digits (colon or space separators may be present) which
335# identifies a certificate in the set of certificates supplied during cert path
336# validation. When this property is set then the "ocsp.responderCertIssuerName"
337# property must also be set. When the "ocsp.responderCertSubjectName" property
338# is set then this property is ignored.
339#
340# Example,
341# ocsp.responderCertSerialNumber=2A:FF:00
weijun0f0fb6a2009-12-24 13:56:19 +0800342
343#
344# Policy for failed Kerberos KDC lookups:
345#
346# When a KDC is unavailable (network error, service failure, etc), it is
347# put inside a blacklist and accessed less often for future requests. The
348# value (case-insensitive) for this policy can be:
349#
350# tryLast
351# KDCs in the blacklist are always tried after those not on the list.
352#
353# tryLess[:max_retries,timeout]
354# KDCs in the blacklist are still tried by their order in the configuration,
355# but with smaller max_retries and timeout values. max_retries and timeout
356# are optional numerical parameters (default 1 and 5000, which means once
357# and 5 seconds). Please notes that if any of the values defined here is
358# more than what is defined in krb5.conf, it will be ignored.
359#
360# Whenever a KDC is detected as available, it is removed from the blacklist.
361# The blacklist is reset when krb5.conf is reloaded. You can add
362# refreshKrb5Config=true to a JAAS configuration file so that krb5.conf is
363# reloaded whenever a JAAS authentication is attempted.
364#
365# Example,
366# krb5.kdc.bad.policy = tryLast
367# krb5.kdc.bad.policy = tryLess:2,2000
368krb5.kdc.bad.policy = tryLast
369
xuelei42dd6452010-11-01 07:57:46 -0700370# Algorithm restrictions for certification path (CertPath) processing
371#
372# In some environments, certain algorithms or key lengths may be undesirable
373# for certification path building and validation. For example, "MD2" is
374# generally no longer considered to be a secure hash algorithm. This section
375# describes the mechanism for disabling algorithms based on algorithm name
376# and/or key length. This includes algorithms used in certificates, as well
377# as revocation information such as CRLs and signed OCSP Responses.
378#
379# The syntax of the disabled algorithm string is described as this Java
380# BNF-style:
381# DisabledAlgorithms:
382# " DisabledAlgorithm { , DisabledAlgorithm } "
383#
384# DisabledAlgorithm:
385# AlgorithmName [Constraint]
386#
387# AlgorithmName:
388# (see below)
389#
390# Constraint:
391# KeySizeConstraint
392#
393# KeySizeConstraint:
394# keySize Operator DecimalInteger
395#
396# Operator:
397# <= | < | == | != | >= | >
398#
399# DecimalInteger:
400# DecimalDigits
401#
402# DecimalDigits:
403# DecimalDigit {DecimalDigit}
404#
405# DecimalDigit: one of
406# 1 2 3 4 5 6 7 8 9 0
407#
408# The "AlgorithmName" is the standard algorithm name of the disabled
409# algorithm. See "Java Cryptography Architecture Standard Algorithm Name
410# Documentation" for information about Standard Algorithm Names. Matching
411# is performed using a case-insensitive sub-element matching rule. (For
412# example, in "SHA1withECDSA" the sub-elements are "SHA1" for hashing and
413# "ECDSA" for signatures.) If the assertion "AlgorithmName" is a
414# sub-element of the certificate algorithm name, the algorithm will be
415# rejected during certification path building and validation. For example,
416# the assertion algorithm name "DSA" will disable all certificate algorithms
417# that rely on DSA, such as NONEwithDSA, SHA1withDSA. However, the assertion
418# will not disable algorithms related to "ECDSA".
419#
420# A "Constraint" provides further guidance for the algorithm being specified.
421# The "KeySizeConstraint" requires a key of a valid size range if the
422# "AlgorithmName" is of a key algorithm. The "DecimalInteger" indicates the
423# key size specified in number of bits. For example, "RSA keySize <= 1024"
424# indicates that any RSA key with key size less than or equal to 1024 bits
425# should be disabled, and "RSA keySize < 1024, RSA keySize > 2048" indicates
426# that any RSA key with key size less than 1024 or greater than 2048 should
427# be disabled. Note that the "KeySizeConstraint" only makes sense to key
428# algorithms.
429#
430# Note: This property is currently used by Oracle's PKIX implementation. It
431# is not guaranteed to be examined and used by other implementations.
432#
433# Example:
434# jdk.certpath.disabledAlgorithms=MD2, DSA, RSA keySize < 2048
435#
436#
xuelei7b2dfe72012-12-28 00:48:12 -0800437jdk.certpath.disabledAlgorithms=MD2, RSA keySize < 1024
xuelei42dd6452010-11-01 07:57:46 -0700438
439# Algorithm restrictions for Secure Socket Layer/Transport Layer Security
440# (SSL/TLS) processing
441#
442# In some environments, certain algorithms or key lengths may be undesirable
443# when using SSL/TLS. This section describes the mechanism for disabling
444# algorithms during SSL/TLS security parameters negotiation, including cipher
445# suites selection, peer authentication and key exchange mechanisms.
446#
447# For PKI-based peer authentication and key exchange mechanisms, this list
448# of disabled algorithms will also be checked during certification path
449# building and validation, including algorithms used in certificates, as
450# well as revocation information such as CRLs and signed OCSP Responses.
451# This is in addition to the jdk.certpath.disabledAlgorithms property above.
452#
453# See the specification of "jdk.certpath.disabledAlgorithms" for the
454# syntax of the disabled algorithm string.
455#
456# Note: This property is currently used by Oracle's JSSE implementation.
457# It is not guaranteed to be examined and used by other implementations.
458#
459# Example:
460# jdk.tls.disabledAlgorithms=MD5, SHA1, DSA, RSA keySize < 2048
461