blob: 43621a48511850356b561743506c095bdf9aa45e [file] [log] [blame]
duke6e45e102007-12-01 00:00:00 +00001#
2# This is the "master security properties file".
3#
4# In this file, various security properties are set for use by
5# java.security classes. This is where users can statically register
6# Cryptography Package Providers ("providers" for short). The term
7# "provider" refers to a package or set of packages that supply a
8# concrete implementation of a subset of the cryptography aspects of
9# the Java Security API. A provider may, for example, implement one or
10# more digital signature algorithms or message digest algorithms.
11#
12# Each provider must implement a subclass of the Provider class.
13# To register a provider in this master security properties file,
14# specify the Provider subclass name and priority in the format
15#
16# security.provider.<n>=<className>
17#
18# This declares a provider, and specifies its preference
19# order n. The preference order is the order in which providers are
20# searched for requested algorithms (when no specific provider is
21# requested). The order is 1-based; 1 is the most preferred, followed
22# by 2, and so on.
23#
24# <className> must specify the subclass of the Provider class whose
25# constructor sets the values of various properties that are required
26# for the Java Security API to look up the algorithms or other
27# facilities implemented by the provider.
28#
29# There must be at least one provider specification in java.security.
30# There is a default provider that comes standard with the JDK. It
31# is called the "SUN" provider, and its Provider subclass
32# named Sun appears in the sun.security.provider package. Thus, the
33# "SUN" provider is registered via the following:
34#
35# security.provider.1=sun.security.provider.Sun
36#
37# (The number 1 is used for the default provider.)
38#
39# Note: Providers can be dynamically registered instead by calls to
40# either the addProvider or insertProviderAt method in the Security
41# class.
42
43#
44# List of providers and their preference orders (see above):
45#
46security.provider.1=sun.security.pkcs11.SunPKCS11 ${java.home}/lib/security/sunpkcs11-solaris.cfg
47security.provider.2=sun.security.provider.Sun
48security.provider.3=sun.security.rsa.SunRsaSign
vinnieed355ab2009-08-11 16:52:26 +010049security.provider.4=sun.security.ec.SunEC
50security.provider.5=com.sun.net.ssl.internal.ssl.Provider
51security.provider.6=com.sun.crypto.provider.SunJCE
52security.provider.7=sun.security.jgss.SunProvider
53security.provider.8=com.sun.security.sasl.Provider
54security.provider.9=org.jcp.xml.dsig.internal.dom.XMLDSigRI
55security.provider.10=sun.security.smartcardio.SunPCSC
duke6e45e102007-12-01 00:00:00 +000056
57#
58# Select the source of seed data for SecureRandom. By default an
59# attempt is made to use the entropy gathering device specified by
60# the securerandom.source property. If an exception occurs when
61# accessing the URL then the traditional system/thread activity
62# algorithm is used.
63#
64# On Solaris and Linux systems, if file:/dev/urandom is specified and it
65# exists, a special SecureRandom implementation is activated by default.
66# This "NativePRNG" reads random bytes directly from /dev/urandom.
67#
68# On Windows systems, the URLs file:/dev/random and file:/dev/urandom
69# enables use of the Microsoft CryptoAPI seed functionality.
70#
71securerandom.source=file:/dev/urandom
72#
73# The entropy gathering device is described as a URL and can also
74# be specified with the system property "java.security.egd". For example,
75# -Djava.security.egd=file:/dev/urandom
76# Specifying this system property will override the securerandom.source
77# setting.
78
79#
80# Class to instantiate as the javax.security.auth.login.Configuration
81# provider.
82#
83login.configuration.provider=com.sun.security.auth.login.ConfigFile
84
85#
86# Default login configuration file
87#
88#login.config.url.1=file:${user.home}/.java.login.config
89
90#
91# Class to instantiate as the system Policy. This is the name of the class
92# that will be used as the Policy object.
93#
94policy.provider=sun.security.provider.PolicyFile
95
96# The default is to have a single system-wide policy file,
97# and a policy file in the user's home directory.
98policy.url.1=file:${java.home}/lib/security/java.policy
99policy.url.2=file:${user.home}/.java.policy
100
101# whether or not we expand properties in the policy file
102# if this is set to false, properties (${...}) will not be expanded in policy
103# files.
104policy.expandProperties=true
105
106# whether or not we allow an extra policy to be passed on the command line
107# with -Djava.security.policy=somefile. Comment out this line to disable
108# this feature.
109policy.allowSystemProperty=true
110
111# whether or not we look into the IdentityScope for trusted Identities
112# when encountering a 1.1 signed JAR file. If the identity is found
113# and is trusted, we grant it AllPermission.
114policy.ignoreIdentityScope=false
115
116#
117# Default keystore type.
118#
119keystore.type=jks
120
121#
122# Class to instantiate as the system scope:
123#
124system.scope=sun.security.provider.IdentityDatabase
125
126#
127# List of comma-separated packages that start with or equal this string
128# will cause a security exception to be thrown when
129# passed to checkPackageAccess unless the
130# corresponding RuntimePermission ("accessClassInPackage."+package) has
131# been granted.
bae8b3ebb12009-05-08 15:57:33 +0400132package.access=sun.,com.sun.imageio.
duke6e45e102007-12-01 00:00:00 +0000133
134#
135# List of comma-separated packages that start with or equal this string
136# will cause a security exception to be thrown when
137# passed to checkPackageDefinition unless the
138# corresponding RuntimePermission ("defineClassInPackage."+package) has
139# been granted.
140#
141# by default, no packages are restricted for definition, and none of
142# the class loaders supplied with the JDK call checkPackageDefinition.
143#
144#package.definition=
145
146#
147# Determines whether this properties file can be appended to
148# or overridden on the command line via -Djava.security.properties
149#
150security.overridePropertiesFile=true
151
152#
153# Determines the default key and trust manager factory algorithms for
154# the javax.net.ssl package.
155#
156ssl.KeyManagerFactory.algorithm=SunX509
157ssl.TrustManagerFactory.algorithm=PKIX
158
159#
160# The Java-level namelookup cache policy for successful lookups:
161#
162# any negative value: caching forever
163# any positive value: the number of seconds to cache an address for
164# zero: do not cache
165#
166# default value is forever (FOREVER). For security reasons, this
167# caching is made forever when a security manager is set. When a security
168# manager is not set, the default behavior is to cache for 30 seconds.
169#
170# NOTE: setting this to anything other than the default value can have
171# serious security implications. Do not set it unless
172# you are sure you are not exposed to DNS spoofing attack.
173#
174#networkaddress.cache.ttl=-1
175
176# The Java-level namelookup cache policy for failed lookups:
177#
178# any negative value: cache forever
179# any positive value: the number of seconds to cache negative lookup results
180# zero: do not cache
181#
182# In some Microsoft Windows networking environments that employ
183# the WINS name service in addition to DNS, name service lookups
184# that fail may take a noticeably long time to return (approx. 5 seconds).
185# For this reason the default caching policy is to maintain these
186# results for 10 seconds.
187#
188#
189networkaddress.cache.negative.ttl=10
190
191#
192# Properties to configure OCSP for certificate revocation checking
193#
194
195# Enable OCSP
196#
197# By default, OCSP is not used for certificate revocation checking.
198# This property enables the use of OCSP when set to the value "true".
199#
200# NOTE: SocketPermission is required to connect to an OCSP responder.
201#
202# Example,
203# ocsp.enable=true
204
205#
206# Location of the OCSP responder
207#
208# By default, the location of the OCSP responder is determined implicitly
209# from the certificate being validated. This property explicitly specifies
210# the location of the OCSP responder. The property is used when the
211# Authority Information Access extension (defined in RFC 3280) is absent
212# from the certificate or when it requires overriding.
213#
214# Example,
215# ocsp.responderURL=http://ocsp.example.net:80
216
217#
218# Subject name of the OCSP responder's certificate
219#
220# By default, the certificate of the OCSP responder is that of the issuer
221# of the certificate being validated. This property identifies the certificate
222# of the OCSP responder when the default does not apply. Its value is a string
223# distinguished name (defined in RFC 2253) which identifies a certificate in
224# the set of certificates supplied during cert path validation. In cases where
225# the subject name alone is not sufficient to uniquely identify the certificate
226# then both the "ocsp.responderCertIssuerName" and
227# "ocsp.responderCertSerialNumber" properties must be used instead. When this
228# property is set then those two properties are ignored.
229#
230# Example,
231# ocsp.responderCertSubjectName="CN=OCSP Responder, O=XYZ Corp"
232
233#
234# Issuer name of the OCSP responder's certificate
235#
236# By default, the certificate of the OCSP responder is that of the issuer
237# of the certificate being validated. This property identifies the certificate
238# of the OCSP responder when the default does not apply. Its value is a string
239# distinguished name (defined in RFC 2253) which identifies a certificate in
240# the set of certificates supplied during cert path validation. When this
241# property is set then the "ocsp.responderCertSerialNumber" property must also
242# be set. When the "ocsp.responderCertSubjectName" property is set then this
243# property is ignored.
244#
245# Example,
246# ocsp.responderCertIssuerName="CN=Enterprise CA, O=XYZ Corp"
247
248#
249# Serial number of the OCSP responder's certificate
250#
251# By default, the certificate of the OCSP responder is that of the issuer
252# of the certificate being validated. This property identifies the certificate
253# of the OCSP responder when the default does not apply. Its value is a string
254# of hexadecimal digits (colon or space separators may be present) which
255# identifies a certificate in the set of certificates supplied during cert path
256# validation. When this property is set then the "ocsp.responderCertIssuerName"
257# property must also be set. When the "ocsp.responderCertSubjectName" property
258# is set then this property is ignored.
259#
260# Example,
261# ocsp.responderCertSerialNumber=2A:FF:00
262
weijunf49e12c2010-08-19 11:26:32 +0800263#
264# Policy for failed Kerberos KDC lookups:
265#
266# When a KDC is unavailable (network error, service failure, etc), it is
267# put inside a blacklist and accessed less often for future requests. The
268# value (case-insensitive) for this policy can be:
269#
270# tryLast
271# KDCs in the blacklist are always tried after those not on the list.
272#
273# tryLess[:max_retries,timeout]
274# KDCs in the blacklist are still tried by their order in the configuration,
275# but with smaller max_retries and timeout values. max_retries and timeout
276# are optional numerical parameters (default 1 and 5000, which means once
277# and 5 seconds). Please notes that if any of the values defined here is
278# more than what is defined in krb5.conf, it will be ignored.
279#
280# Whenever a KDC is detected as available, it is removed from the blacklist.
281# The blacklist is reset when krb5.conf is reloaded. You can add
282# refreshKrb5Config=true to a JAAS configuration file so that krb5.conf is
283# reloaded whenever a JAAS authentication is attempted.
284#
285# Example,
286# krb5.kdc.bad.policy = tryLast
287# krb5.kdc.bad.policy = tryLess:2,2000
288krb5.kdc.bad.policy = tryLast
289