blob: 404bfdda72eb6cea99d04fb51d15e0560370e2e1 [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#
valeriep382c94a2012-01-12 16:04:03 -080068security.provider.1=com.oracle.security.ucrypto.UcryptoProvider ${java.home}/lib/security/ucrypto-solaris.cfg
69security.provider.2=sun.security.pkcs11.SunPKCS11 ${java.home}/lib/security/sunpkcs11-solaris.cfg
70security.provider.3=sun.security.provider.Sun
71security.provider.4=sun.security.rsa.SunRsaSign
72security.provider.5=sun.security.ec.SunEC
73security.provider.6=com.sun.net.ssl.internal.ssl.Provider
74security.provider.7=com.sun.crypto.provider.SunJCE
75security.provider.8=sun.security.jgss.SunProvider
76security.provider.9=com.sun.security.sasl.Provider
77security.provider.10=org.jcp.xml.dsig.internal.dom.XMLDSigRI
78security.provider.11=sun.security.smartcardio.SunPCSC
duke6e45e102007-12-01 00:00:00 +000079
80#
wetmore5f58e202013-04-11 21:03:24 -070081# Sun Provider SecureRandom seed source.
duke6e45e102007-12-01 00:00:00 +000082#
wetmore5f58e202013-04-11 21:03:24 -070083# Select the primary source of seed data for the "SHA1PRNG" and
84# "NativePRNG" SecureRandom implementations in the "Sun" provider.
85# (Other SecureRandom implementations might also use this property.)
duke6e45e102007-12-01 00:00:00 +000086#
wetmore5f58e202013-04-11 21:03:24 -070087# On Unix-like systems (for example, Solaris/Linux/MacOS), the
88# "NativePRNG" and "SHA1PRNG" implementations obtains seed data from
89# special device files such as file:/dev/random.
duke6e45e102007-12-01 00:00:00 +000090#
wetmore5f58e202013-04-11 21:03:24 -070091# On Windows systems, specifying the URLs "file:/dev/random" or
92# "file:/dev/urandom" will enable the native Microsoft CryptoAPI seeding
93# mechanism for SHA1PRNG.
duke6e45e102007-12-01 00:00:00 +000094#
wetmore5f58e202013-04-11 21:03:24 -070095# By default, an attempt is made to use the entropy gathering device
96# specified by the "securerandom.source" Security property. If an
97# exception occurs while accessing the specified URL:
98#
99# SHA1PRNG:
100# the traditional system/thread activity algorithm will be used.
101#
102# NativePRNG:
103# a default value of /dev/random will be used. If neither
104# are available, the implementation will be disabled.
105# "file" is the only currently supported protocol type.
106#
107# The entropy gathering device can also be specified with the System
108# property "java.security.egd". For example:
109#
110# % java -Djava.security.egd=file:/dev/random MainClass
111#
112# Specifying this System property will override the
113# "securerandom.source" Security property.
114#
115# In addition, if "file:/dev/random" or "file:/dev/urandom" is
116# specified, the "NativePRNG" implementation will be more preferred than
117# SHA1PRNG in the Sun provider.
118#
119securerandom.source=file:/dev/random
120
121#
122# A list of known strong SecureRandom implementations.
123#
124# To help guide applications in selecting a suitable strong
125# java.security.SecureRandom implementation, Java distributions should
126# indicate a list of known strong implementations using the property.
127#
128# This is a comma-separated list of algorithm and/or algorithm:provider
129# entries.
130#
131securerandom.strongAlgorithms=NativePRNGBlocking:SUN
duke6e45e102007-12-01 00:00:00 +0000132
133#
134# Class to instantiate as the javax.security.auth.login.Configuration
135# provider.
136#
mullan45ec39b2013-08-12 09:03:51 -0400137login.configuration.provider=sun.security.provider.ConfigFile
duke6e45e102007-12-01 00:00:00 +0000138
139#
140# Default login configuration file
141#
142#login.config.url.1=file:${user.home}/.java.login.config
143
144#
145# Class to instantiate as the system Policy. This is the name of the class
146# that will be used as the Policy object.
147#
148policy.provider=sun.security.provider.PolicyFile
149
150# The default is to have a single system-wide policy file,
151# and a policy file in the user's home directory.
152policy.url.1=file:${java.home}/lib/security/java.policy
153policy.url.2=file:${user.home}/.java.policy
154
155# whether or not we expand properties in the policy file
156# if this is set to false, properties (${...}) will not be expanded in policy
157# files.
158policy.expandProperties=true
159
160# whether or not we allow an extra policy to be passed on the command line
161# with -Djava.security.policy=somefile. Comment out this line to disable
162# this feature.
163policy.allowSystemProperty=true
164
165# whether or not we look into the IdentityScope for trusted Identities
166# when encountering a 1.1 signed JAR file. If the identity is found
167# and is trusted, we grant it AllPermission.
168policy.ignoreIdentityScope=false
169
170#
171# Default keystore type.
172#
173keystore.type=jks
174
175#
vinnie79f6ac42015-05-25 09:18:22 +0100176# Controls compatibility mode for the JKS keystore type.
177#
178# When set to 'true', the JKS keystore type supports loading
179# keystore files in either JKS or PKCS12 format. When set to 'false'
180# it supports loading only JKS keystore files.
181#
182keystore.type.compat=true
183
184#
duke6e45e102007-12-01 00:00:00 +0000185# List of comma-separated packages that start with or equal this string
186# will cause a security exception to be thrown when
187# passed to checkPackageAccess unless the
188# corresponding RuntimePermission ("accessClassInPackage."+package) has
189# been granted.
mullan54257132012-10-26 15:21:05 -0400190package.access=sun.,\
mkosa265cf42013-03-07 07:19:35 -0500191 com.sun.xml.internal.,\
mullan54257132012-10-26 15:21:05 -0400192 com.sun.imageio.,\
mchung60367132012-12-05 14:02:58 -0800193 com.sun.istack.internal.,\
dfuchs0fe8bdd2013-01-30 11:33:51 +0100194 com.sun.jmx.,\
mullan40a8bb12013-08-27 12:04:32 -0400195 com.sun.media.sound.,\
weijun50ac0602013-08-16 17:57:27 +0800196 com.sun.naming.internal.,\
mchung1cdf5492013-01-28 15:53:29 -0800197 com.sun.proxy.,\
alanba8f88702013-10-22 11:43:04 +0100198 com.sun.corba.se.,\
joehwf5a92592013-02-18 13:02:09 -0800199 com.sun.org.apache.bcel.internal.,\
200 com.sun.org.apache.regexp.internal.,\
201 com.sun.org.apache.xerces.internal.,\
202 com.sun.org.apache.xpath.internal.,\
203 com.sun.org.apache.xalan.internal.extensions.,\
204 com.sun.org.apache.xalan.internal.lib.,\
205 com.sun.org.apache.xalan.internal.res.,\
206 com.sun.org.apache.xalan.internal.templates.,\
mullan54257132012-10-26 15:21:05 -0400207 com.sun.org.apache.xalan.internal.utils.,\
joehwf5a92592013-02-18 13:02:09 -0800208 com.sun.org.apache.xalan.internal.xslt.,\
209 com.sun.org.apache.xalan.internal.xsltc.cmdline.,\
210 com.sun.org.apache.xalan.internal.xsltc.compiler.,\
211 com.sun.org.apache.xalan.internal.xsltc.trax.,\
212 com.sun.org.apache.xalan.internal.xsltc.util.,\
213 com.sun.org.apache.xml.internal.res.,\
mullanbd2ff8c2013-04-22 11:23:33 +0100214 com.sun.org.apache.xml.internal.security.,\
joehwf5a92592013-02-18 13:02:09 -0800215 com.sun.org.apache.xml.internal.serializer.utils.,\
216 com.sun.org.apache.xml.internal.utils.,\
mullanf180f522013-03-27 10:37:46 +0000217 com.sun.org.glassfish.,\
alanba3151942013-04-09 15:51:50 +0100218 com.oracle.xmlns.internal.,\
219 com.oracle.webservices.internal.,\
chegar3e6a4102013-09-06 13:36:33 +0100220 oracle.jrockit.jfr.,\
mullanbd2ff8c2013-04-22 11:23:33 +0100221 org.jcp.xml.dsig.internal.,\
wetmore5f58e202013-04-11 21:03:24 -0700222 jdk.internal.,\
223 jdk.nashorn.internal.,\
mkos287fd472014-04-06 23:53:37 +0200224 jdk.nashorn.tools.,\
225 com.sun.activation.registries.
duke6e45e102007-12-01 00:00:00 +0000226
227#
228# List of comma-separated packages that start with or equal this string
229# will cause a security exception to be thrown when
230# passed to checkPackageDefinition unless the
231# corresponding RuntimePermission ("defineClassInPackage."+package) has
232# been granted.
233#
mullanee9229d2012-02-22 15:38:24 -0500234# by default, none of the class loaders supplied with the JDK call
235# checkPackageDefinition.
duke6e45e102007-12-01 00:00:00 +0000236#
mullan54257132012-10-26 15:21:05 -0400237package.definition=sun.,\
mkosa265cf42013-03-07 07:19:35 -0500238 com.sun.xml.internal.,\
mullan54257132012-10-26 15:21:05 -0400239 com.sun.imageio.,\
mchung60367132012-12-05 14:02:58 -0800240 com.sun.istack.internal.,\
dfuchs0fe8bdd2013-01-30 11:33:51 +0100241 com.sun.jmx.,\
mullan40a8bb12013-08-27 12:04:32 -0400242 com.sun.media.sound.,\
weijun50ac0602013-08-16 17:57:27 +0800243 com.sun.naming.internal.,\
mchung1cdf5492013-01-28 15:53:29 -0800244 com.sun.proxy.,\
alanba8f88702013-10-22 11:43:04 +0100245 com.sun.corba.se.,\
joehwf5a92592013-02-18 13:02:09 -0800246 com.sun.org.apache.bcel.internal.,\
247 com.sun.org.apache.regexp.internal.,\
248 com.sun.org.apache.xerces.internal.,\
249 com.sun.org.apache.xpath.internal.,\
250 com.sun.org.apache.xalan.internal.extensions.,\
251 com.sun.org.apache.xalan.internal.lib.,\
252 com.sun.org.apache.xalan.internal.res.,\
253 com.sun.org.apache.xalan.internal.templates.,\
mullan54257132012-10-26 15:21:05 -0400254 com.sun.org.apache.xalan.internal.utils.,\
joehwf5a92592013-02-18 13:02:09 -0800255 com.sun.org.apache.xalan.internal.xslt.,\
256 com.sun.org.apache.xalan.internal.xsltc.cmdline.,\
257 com.sun.org.apache.xalan.internal.xsltc.compiler.,\
258 com.sun.org.apache.xalan.internal.xsltc.trax.,\
259 com.sun.org.apache.xalan.internal.xsltc.util.,\
260 com.sun.org.apache.xml.internal.res.,\
mullanbd2ff8c2013-04-22 11:23:33 +0100261 com.sun.org.apache.xml.internal.security.,\
joehwf5a92592013-02-18 13:02:09 -0800262 com.sun.org.apache.xml.internal.serializer.utils.,\
263 com.sun.org.apache.xml.internal.utils.,\
mullanf180f522013-03-27 10:37:46 +0000264 com.sun.org.glassfish.,\
alanba3151942013-04-09 15:51:50 +0100265 com.oracle.xmlns.internal.,\
266 com.oracle.webservices.internal.,\
chegar3e6a4102013-09-06 13:36:33 +0100267 oracle.jrockit.jfr.,\
mullanbd2ff8c2013-04-22 11:23:33 +0100268 org.jcp.xml.dsig.internal.,\
wetmore5f58e202013-04-11 21:03:24 -0700269 jdk.internal.,\
270 jdk.nashorn.internal.,\
mkos287fd472014-04-06 23:53:37 +0200271 jdk.nashorn.tools.,\
272 com.sun.activation.registries.
duke6e45e102007-12-01 00:00:00 +0000273
274#
275# Determines whether this properties file can be appended to
276# or overridden on the command line via -Djava.security.properties
277#
278security.overridePropertiesFile=true
279
280#
xuelei42dd6452010-11-01 07:57:46 -0700281# Determines the default key and trust manager factory algorithms for
duke6e45e102007-12-01 00:00:00 +0000282# the javax.net.ssl package.
283#
284ssl.KeyManagerFactory.algorithm=SunX509
285ssl.TrustManagerFactory.algorithm=PKIX
286
287#
288# The Java-level namelookup cache policy for successful lookups:
289#
290# any negative value: caching forever
291# any positive value: the number of seconds to cache an address for
292# zero: do not cache
293#
294# default value is forever (FOREVER). For security reasons, this
295# caching is made forever when a security manager is set. When a security
xuelei42dd6452010-11-01 07:57:46 -0700296# manager is not set, the default behavior in this implementation
297# is to cache for 30 seconds.
duke6e45e102007-12-01 00:00:00 +0000298#
299# NOTE: setting this to anything other than the default value can have
xuelei42dd6452010-11-01 07:57:46 -0700300# serious security implications. Do not set it unless
duke6e45e102007-12-01 00:00:00 +0000301# you are sure you are not exposed to DNS spoofing attack.
302#
xuelei42dd6452010-11-01 07:57:46 -0700303#networkaddress.cache.ttl=-1
duke6e45e102007-12-01 00:00:00 +0000304
305# The Java-level namelookup cache policy for failed lookups:
306#
307# any negative value: cache forever
308# any positive value: the number of seconds to cache negative lookup results
309# zero: do not cache
310#
311# In some Microsoft Windows networking environments that employ
312# the WINS name service in addition to DNS, name service lookups
313# that fail may take a noticeably long time to return (approx. 5 seconds).
314# For this reason the default caching policy is to maintain these
xuelei42dd6452010-11-01 07:57:46 -0700315# results for 10 seconds.
duke6e45e102007-12-01 00:00:00 +0000316#
317#
318networkaddress.cache.negative.ttl=10
319
320#
321# Properties to configure OCSP for certificate revocation checking
322#
323
xuelei42dd6452010-11-01 07:57:46 -0700324# Enable OCSP
duke6e45e102007-12-01 00:00:00 +0000325#
326# By default, OCSP is not used for certificate revocation checking.
327# This property enables the use of OCSP when set to the value "true".
328#
329# NOTE: SocketPermission is required to connect to an OCSP responder.
330#
331# Example,
332# ocsp.enable=true
xuelei42dd6452010-11-01 07:57:46 -0700333
duke6e45e102007-12-01 00:00:00 +0000334#
335# Location of the OCSP responder
336#
337# By default, the location of the OCSP responder is determined implicitly
338# from the certificate being validated. This property explicitly specifies
339# the location of the OCSP responder. The property is used when the
340# Authority Information Access extension (defined in RFC 3280) is absent
341# from the certificate or when it requires overriding.
342#
343# Example,
344# ocsp.responderURL=http://ocsp.example.net:80
xuelei42dd6452010-11-01 07:57:46 -0700345
duke6e45e102007-12-01 00:00:00 +0000346#
347# Subject name of the OCSP responder's certificate
348#
349# By default, the certificate of the OCSP responder is that of the issuer
350# of the certificate being validated. This property identifies the certificate
xuelei42dd6452010-11-01 07:57:46 -0700351# of the OCSP responder when the default does not apply. Its value is a string
352# distinguished name (defined in RFC 2253) which identifies a certificate in
353# the set of certificates supplied during cert path validation. In cases where
duke6e45e102007-12-01 00:00:00 +0000354# the subject name alone is not sufficient to uniquely identify the certificate
355# then both the "ocsp.responderCertIssuerName" and
356# "ocsp.responderCertSerialNumber" properties must be used instead. When this
357# property is set then those two properties are ignored.
358#
359# Example,
360# ocsp.responderCertSubjectName="CN=OCSP Responder, O=XYZ Corp"
361
362#
363# Issuer name of the OCSP responder's certificate
364#
365# By default, the certificate of the OCSP responder is that of the issuer
366# of the certificate being validated. This property identifies the certificate
367# of the OCSP responder when the default does not apply. Its value is a string
368# distinguished name (defined in RFC 2253) which identifies a certificate in
xuelei42dd6452010-11-01 07:57:46 -0700369# the set of certificates supplied during cert path validation. When this
370# property is set then the "ocsp.responderCertSerialNumber" property must also
371# be set. When the "ocsp.responderCertSubjectName" property is set then this
duke6e45e102007-12-01 00:00:00 +0000372# property is ignored.
373#
374# Example,
375# ocsp.responderCertIssuerName="CN=Enterprise CA, O=XYZ Corp"
xuelei42dd6452010-11-01 07:57:46 -0700376
duke6e45e102007-12-01 00:00:00 +0000377#
378# Serial number of the OCSP responder's certificate
379#
380# By default, the certificate of the OCSP responder is that of the issuer
381# of the certificate being validated. This property identifies the certificate
382# of the OCSP responder when the default does not apply. Its value is a string
383# of hexadecimal digits (colon or space separators may be present) which
384# identifies a certificate in the set of certificates supplied during cert path
385# validation. When this property is set then the "ocsp.responderCertIssuerName"
386# property must also be set. When the "ocsp.responderCertSubjectName" property
387# is set then this property is ignored.
388#
389# Example,
390# ocsp.responderCertSerialNumber=2A:FF:00
xuelei42dd6452010-11-01 07:57:46 -0700391
weijunf49e12c2010-08-19 11:26:32 +0800392#
393# Policy for failed Kerberos KDC lookups:
394#
395# When a KDC is unavailable (network error, service failure, etc), it is
396# put inside a blacklist and accessed less often for future requests. The
397# value (case-insensitive) for this policy can be:
398#
399# tryLast
400# KDCs in the blacklist are always tried after those not on the list.
401#
402# tryLess[:max_retries,timeout]
403# KDCs in the blacklist are still tried by their order in the configuration,
404# but with smaller max_retries and timeout values. max_retries and timeout
405# are optional numerical parameters (default 1 and 5000, which means once
406# and 5 seconds). Please notes that if any of the values defined here is
407# more than what is defined in krb5.conf, it will be ignored.
408#
409# Whenever a KDC is detected as available, it is removed from the blacklist.
410# The blacklist is reset when krb5.conf is reloaded. You can add
411# refreshKrb5Config=true to a JAAS configuration file so that krb5.conf is
412# reloaded whenever a JAAS authentication is attempted.
413#
414# Example,
415# krb5.kdc.bad.policy = tryLast
416# krb5.kdc.bad.policy = tryLess:2,2000
417krb5.kdc.bad.policy = tryLast
418
xuelei42dd6452010-11-01 07:57:46 -0700419# Algorithm restrictions for certification path (CertPath) processing
420#
421# In some environments, certain algorithms or key lengths may be undesirable
422# for certification path building and validation. For example, "MD2" is
423# generally no longer considered to be a secure hash algorithm. This section
424# describes the mechanism for disabling algorithms based on algorithm name
425# and/or key length. This includes algorithms used in certificates, as well
426# as revocation information such as CRLs and signed OCSP Responses.
427#
428# The syntax of the disabled algorithm string is described as this Java
429# BNF-style:
430# DisabledAlgorithms:
431# " DisabledAlgorithm { , DisabledAlgorithm } "
432#
433# DisabledAlgorithm:
434# AlgorithmName [Constraint]
435#
436# AlgorithmName:
437# (see below)
438#
439# Constraint:
440# KeySizeConstraint
441#
442# KeySizeConstraint:
443# keySize Operator DecimalInteger
444#
445# Operator:
446# <= | < | == | != | >= | >
447#
448# DecimalInteger:
449# DecimalDigits
450#
451# DecimalDigits:
452# DecimalDigit {DecimalDigit}
453#
454# DecimalDigit: one of
455# 1 2 3 4 5 6 7 8 9 0
456#
457# The "AlgorithmName" is the standard algorithm name of the disabled
458# algorithm. See "Java Cryptography Architecture Standard Algorithm Name
459# Documentation" for information about Standard Algorithm Names. Matching
460# is performed using a case-insensitive sub-element matching rule. (For
461# example, in "SHA1withECDSA" the sub-elements are "SHA1" for hashing and
462# "ECDSA" for signatures.) If the assertion "AlgorithmName" is a
463# sub-element of the certificate algorithm name, the algorithm will be
464# rejected during certification path building and validation. For example,
465# the assertion algorithm name "DSA" will disable all certificate algorithms
466# that rely on DSA, such as NONEwithDSA, SHA1withDSA. However, the assertion
467# will not disable algorithms related to "ECDSA".
468#
469# A "Constraint" provides further guidance for the algorithm being specified.
470# The "KeySizeConstraint" requires a key of a valid size range if the
471# "AlgorithmName" is of a key algorithm. The "DecimalInteger" indicates the
472# key size specified in number of bits. For example, "RSA keySize <= 1024"
473# indicates that any RSA key with key size less than or equal to 1024 bits
474# should be disabled, and "RSA keySize < 1024, RSA keySize > 2048" indicates
475# that any RSA key with key size less than 1024 or greater than 2048 should
476# be disabled. Note that the "KeySizeConstraint" only makes sense to key
477# algorithms.
478#
479# Note: This property is currently used by Oracle's PKIX implementation. It
480# is not guaranteed to be examined and used by other implementations.
481#
482# Example:
483# jdk.certpath.disabledAlgorithms=MD2, DSA, RSA keySize < 2048
484#
485#
asahad301a2c2015-10-01 11:16:16 -0700486jdk.certpath.disabledAlgorithms=MD2, RSA keySize < 1024
xuelei42dd6452010-11-01 07:57:46 -0700487
488# Algorithm restrictions for Secure Socket Layer/Transport Layer Security
489# (SSL/TLS) processing
490#
491# In some environments, certain algorithms or key lengths may be undesirable
492# when using SSL/TLS. This section describes the mechanism for disabling
xuelei64accf52014-10-24 11:49:24 +0000493# algorithms during SSL/TLS security parameters negotiation, including
494# protocol version negotiation, cipher suites selection, peer authentication
495# and key exchange mechanisms.
496#
497# Disabled algorithms will not be negotiated for SSL/TLS connections, even
498# if they are enabled explicitly in an application.
xuelei42dd6452010-11-01 07:57:46 -0700499#
500# For PKI-based peer authentication and key exchange mechanisms, this list
501# of disabled algorithms will also be checked during certification path
502# building and validation, including algorithms used in certificates, as
503# well as revocation information such as CRLs and signed OCSP Responses.
504# This is in addition to the jdk.certpath.disabledAlgorithms property above.
505#
506# See the specification of "jdk.certpath.disabledAlgorithms" for the
507# syntax of the disabled algorithm string.
508#
509# Note: This property is currently used by Oracle's JSSE implementation.
510# It is not guaranteed to be examined and used by other implementations.
511#
512# Example:
xuelei64accf52014-10-24 11:49:24 +0000513# jdk.tls.disabledAlgorithms=MD5, SSLv3, DSA, RSA keySize < 2048
asaha81743b52015-05-29 10:15:38 -0700514jdk.tls.disabledAlgorithms=SSLv3, RC4, DH keySize < 768
asmotrake1347b42015-03-03 16:26:24 -0800515
516# Legacy algorithms for Secure Socket Layer/Transport Layer Security (SSL/TLS)
517# processing in JSSE implementation.
518#
519# In some environments, a certain algorithm may be undesirable but it
520# cannot be disabled because of its use in legacy applications. Legacy
521# algorithms may still be supported, but applications should not use them
522# as the security strength of legacy algorithms are usually not strong enough
523# in practice.
524#
525# During SSL/TLS security parameters negotiation, legacy algorithms will
526# not be negotiated unless there are no other candidates.
527#
528# The syntax of the disabled algorithm string is described as this Java
529# BNF-style:
530# LegacyAlgorithms:
531# " LegacyAlgorithm { , LegacyAlgorithm } "
532#
533# LegacyAlgorithm:
534# AlgorithmName (standard JSSE algorithm name)
535#
536# See the specification of security property "jdk.certpath.disabledAlgorithms"
537# for the syntax and description of the "AlgorithmName" notation.
538#
539# Per SSL/TLS specifications, cipher suites have the form:
540# SSL_KeyExchangeAlg_WITH_CipherAlg_MacAlg
541# or
542# TLS_KeyExchangeAlg_WITH_CipherAlg_MacAlg
543#
544# For example, the cipher suite TLS_RSA_WITH_AES_128_CBC_SHA uses RSA as the
545# key exchange algorithm, AES_128_CBC (128 bits AES cipher algorithm in CBC
546# mode) as the cipher (encryption) algorithm, and SHA-1 as the message digest
547# algorithm for HMAC.
548#
549# The LegacyAlgorithm can be one of the following standard algorithm names:
550# 1. JSSE cipher suite name, e.g., TLS_RSA_WITH_AES_128_CBC_SHA
551# 2. JSSE key exchange algorithm name, e.g., RSA
552# 3. JSSE cipher (encryption) algorithm name, e.g., AES_128_CBC
igerasim558371e2015-04-24 13:59:30 +0300553# 4. JSSE message digest algorithm name, e.g., SHA
asmotrake1347b42015-03-03 16:26:24 -0800554#
555# See SSL/TLS specifications and "Java Cryptography Architecture Standard
556# Algorithm Name Documentation" for information about the algorithm names.
557#
558# Note: This property is currently used by Oracle's JSSE implementation.
559# It is not guaranteed to be examined and used by other implementations.
560# There is no guarantee the property will continue to exist or be of the
561# same syntax in future releases.
562#
563# Example:
564# jdk.tls.legacyAlgorithms=DH_anon, DES_CBC, SSL_RSA_WITH_RC4_128_MD5
565#
566jdk.tls.legacyAlgorithms= \
567 K_NULL, C_NULL, M_NULL, \
568 DHE_DSS_EXPORT, DHE_RSA_EXPORT, DH_anon_EXPORT, DH_DSS_EXPORT, \
569 DH_RSA_EXPORT, RSA_EXPORT, \
570 DH_anon, ECDH_anon, \
571 RC4_128, RC4_40, DES_CBC, DES40_CBC
xuelei4a1259a2015-07-23 09:51:31 +0100572
573# The pre-defined default finite field Diffie-Hellman ephemeral (DHE)
574# parameters for Transport Layer Security (SSL/TLS/DTLS) processing.
575#
576# In traditional SSL/TLS/DTLS connections where finite field DHE parameters
577# negotiation mechanism is not used, the server offers the client group
578# parameters, base generator g and prime modulus p, for DHE key exchange.
579# It is recommended to use dynamic group parameters. This property defines
580# a mechanism that allows you to specify custom group parameters.
581#
582# The syntax of this property string is described as this Java BNF-style:
583# DefaultDHEParameters:
584# DefinedDHEParameters { , DefinedDHEParameters }
585#
586# DefinedDHEParameters:
587# "{" DHEPrimeModulus , DHEBaseGenerator "}"
588#
589# DHEPrimeModulus:
590# HexadecimalDigits
591#
592# DHEBaseGenerator:
593# HexadecimalDigits
594#
595# HexadecimalDigits:
596# HexadecimalDigit { HexadecimalDigit }
597#
598# HexadecimalDigit: one of
599# 0 1 2 3 4 5 6 7 8 9 A B C D E F a b c d e f
600#
601# Whitespace characters are ignored.
602#
603# The "DefinedDHEParameters" defines the custom group parameters, prime
604# modulus p and base generator g, for a particular size of prime modulus p.
605# The "DHEPrimeModulus" defines the hexadecimal prime modulus p, and the
606# "DHEBaseGenerator" defines the hexadecimal base generator g of a group
607# parameter. It is recommended to use safe primes for the custom group
608# parameters.
609#
610# If this property is not defined or the value is empty, the underlying JSSE
611# provider's default group parameter is used for each connection.
612#
613# If the property value does not follow the grammar, or a particular group
614# parameter is not valid, the connection will fall back and use the
615# underlying JSSE provider's default group parameter.
616#
617# Note: This property is currently used by OpenJDK's JSSE implementation. It
618# is not guaranteed to be examined and used by other implementations.
619#
620# Example:
621# jdk.tls.server.defaultDHEParameters=
622# { \
623# FFFFFFFF FFFFFFFF C90FDAA2 2168C234 C4C6628B 80DC1CD1 \
624# 29024E08 8A67CC74 020BBEA6 3B139B22 514A0879 8E3404DD \
625# EF9519B3 CD3A431B 302B0A6D F25F1437 4FE1356D 6D51C245 \
626# E485B576 625E7EC6 F44C42E9 A637ED6B 0BFF5CB6 F406B7ED \
627# EE386BFB 5A899FA5 AE9F2411 7C4B1FE6 49286651 ECE65381 \
628# FFFFFFFF FFFFFFFF, 2}