d95c0de1fbdb66e2aa8d2dc223ad554413f1dc87Julian Kornberger#

d95c0de1fbdb66e2aa8d2dc223ad554413f1dc87Julian Kornberger# This is the "master security properties file".

8abb7a3541206ef22ec2325834410ca2553a85c2Tim Reddehase#

ad3d301b618bf0cac4778b967854c50f486b282bJulian Kornberger# In this file, various security properties are set for use by

ad3d301b618bf0cac4778b967854c50f486b282bJulian Kornberger# java.security classes. This is where users can statically register

8abb7a3541206ef22ec2325834410ca2553a85c2Tim Reddehase# Cryptography Package Providers ("providers" for short). The term

8abb7a3541206ef22ec2325834410ca2553a85c2Tim Reddehase# "provider" refers to a package or set of packages that supply a

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase# concrete implementation of a subset of the cryptography aspects of

8abb7a3541206ef22ec2325834410ca2553a85c2Tim Reddehase# the Java Security API. A provider may, for example, implement one or

8abb7a3541206ef22ec2325834410ca2553a85c2Tim Reddehase# more digital signature algorithms or message digest algorithms.

8abb7a3541206ef22ec2325834410ca2553a85c2Tim Reddehase#

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase# Each provider must implement a subclass of the Provider class.

8abb7a3541206ef22ec2325834410ca2553a85c2Tim Reddehase# To register a provider in this master security properties file,

8abb7a3541206ef22ec2325834410ca2553a85c2Tim Reddehase# specify the Provider subclass name and priority in the format

f6a95bebe3970a55b62d028195351466d063399cTim Reddehase#

31991ca94060fb142844e2592cafe29af9351bb5Tim Reddehase# security.provider.<n>=<className>

f6a95bebe3970a55b62d028195351466d063399cTim Reddehase#

f6a95bebe3970a55b62d028195351466d063399cTim Reddehase# This declares a provider, and specifies its preference

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase# order n. The preference order is the order in which providers are

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase# searched for requested algorithms (when no specific provider is

a6b1ad099899012cfad6da58a5dc8c8ce08bfce4Tim Reddehase# requested). The order is 1-based; 1 is the most preferred, followed

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase# by 2, and so on.

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase#

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase# <className> must specify the subclass of the Provider class whose

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase# constructor sets the values of various properties that are required

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase# for the Java Security API to look up the algorithms or other

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase# facilities implemented by the provider.

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase#

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase# There must be at least one provider specification in java.security.

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase# There is a default provider that comes standard with the JDK. It

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase# is called the "SUN" provider, and its Provider subclass

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase# named Sun appears in the sun.security.provider package. Thus, the

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase# "SUN" provider is registered via the following:

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase#

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase# security.provider.1=sun.security.provider.Sun

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase#

a6b1ad099899012cfad6da58a5dc8c8ce08bfce4Tim Reddehase# (The number 1 is used for the default provider.)

a6b1ad099899012cfad6da58a5dc8c8ce08bfce4Tim Reddehase#

a6b1ad099899012cfad6da58a5dc8c8ce08bfce4Tim Reddehase# Note: Providers can be dynamically registered instead by calls to

a6b1ad099899012cfad6da58a5dc8c8ce08bfce4Tim Reddehase# either the addProvider or insertProviderAt method in the Security

a6b1ad099899012cfad6da58a5dc8c8ce08bfce4Tim Reddehase# class.

a6b1ad099899012cfad6da58a5dc8c8ce08bfce4Tim Reddehase

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehase#

a6b1ad099899012cfad6da58a5dc8c8ce08bfce4Tim Reddehase# List of providers and their preference orders (see above):

a6b1ad099899012cfad6da58a5dc8c8ce08bfce4Tim Reddehase#

c8e6256890e8de1bf26247d87934ef2676691507Tim Reddehasesecurity.provider.1=com.oracle.security.ucrypto.UcryptoProvider ${java.home}/lib/security/ucrypto-solaris.cfg

a6b1ad099899012cfad6da58a5dc8c8ce08bfce4Tim Reddehasesecurity.provider.2=sun.security.pkcs11.SunPKCS11 ${java.home}/lib/security/sunpkcs11-solaris.cfg

a6b1ad099899012cfad6da58a5dc8c8ce08bfce4Tim Reddehasesecurity.provider.3=sun.security.provider.Sun

2382da8dccfccb49e8021a60e4685b9ec861874fTim Reddehasesecurity.provider.4=sun.security.rsa.SunRsaSign

2382da8dccfccb49e8021a60e4685b9ec861874fTim Reddehasesecurity.provider.5=sun.security.ec.SunEC

2382da8dccfccb49e8021a60e4685b9ec861874fTim Reddehasesecurity.provider.6=com.sun.net.ssl.internal.ssl.Provider

2382da8dccfccb49e8021a60e4685b9ec861874fTim Reddehasesecurity.provider.7=com.sun.crypto.provider.SunJCE

a6b1ad099899012cfad6da58a5dc8c8ce08bfce4Tim Reddehasesecurity.provider.8=sun.security.jgss.SunProvider

2382da8dccfccb49e8021a60e4685b9ec861874fTim Reddehasesecurity.provider.9=com.sun.security.sasl.Provider

2382da8dccfccb49e8021a60e4685b9ec861874fTim Reddehasesecurity.provider.10=org.jcp.xml.dsig.internal.dom.XMLDSigRI

2382da8dccfccb49e8021a60e4685b9ec861874fTim Reddehasesecurity.provider.11=sun.security.smartcardio.SunPCSC

2382da8dccfccb49e8021a60e4685b9ec861874fTim Reddehase

2382da8dccfccb49e8021a60e4685b9ec861874fTim Reddehase#

2382da8dccfccb49e8021a60e4685b9ec861874fTim Reddehase# Select the source of seed data for SecureRandom. By default an

2382da8dccfccb49e8021a60e4685b9ec861874fTim Reddehase# attempt is made to use the entropy gathering device specified by

2382da8dccfccb49e8021a60e4685b9ec861874fTim Reddehase# the securerandom.source property. If an exception occurs when

2382da8dccfccb49e8021a60e4685b9ec861874fTim Reddehase# accessing the URL then the traditional system/thread activity

d95c0de1fbdb66e2aa8d2dc223ad554413f1dc87Julian Kornberger# algorithm is used.

8abb7a3541206ef22ec2325834410ca2553a85c2Tim Reddehase#

eec356c819e765d35c3566a5adfb168a12decc9cTim Reddehase# On Solaris and Linux systems, if file:/dev/urandom is specified and it

ad3d301b618bf0cac4778b967854c50f486b282bJulian Kornberger# exists, a special SecureRandom implementation is activated by default.

ad3d301b618bf0cac4778b967854c50f486b282bJulian Kornberger# This "NativePRNG" reads random bytes directly from /dev/urandom.

d95c0de1fbdb66e2aa8d2dc223ad554413f1dc87Julian Kornberger#

d95c0de1fbdb66e2aa8d2dc223ad554413f1dc87Julian Kornberger# On Windows systems, the URLs file:/dev/random and file:/dev/urandom

a6b1ad099899012cfad6da58a5dc8c8ce08bfce4Tim Reddehase# enables use of the Microsoft CryptoAPI seed functionality.

a6b1ad099899012cfad6da58a5dc8c8ce08bfce4Tim Reddehase#

a6b1ad099899012cfad6da58a5dc8c8ce08bfce4Tim Reddehasesecurerandom.source=file:/dev/urandom

a6b1ad099899012cfad6da58a5dc8c8ce08bfce4Tim Reddehase#

dcc3d62e5ee2d3f84edc1b0f8bbaf79e58066799Tim Reddehase# The entropy gathering device is described as a URL and can also

dcc3d62e5ee2d3f84edc1b0f8bbaf79e58066799Tim Reddehase# be specified with the system property "java.security.egd". For example,

dcc3d62e5ee2d3f84edc1b0f8bbaf79e58066799Tim Reddehase# -Djava.security.egd=file:/dev/urandom

dcc3d62e5ee2d3f84edc1b0f8bbaf79e58066799Tim Reddehase# Specifying this system property will override the securerandom.source

dcc3d62e5ee2d3f84edc1b0f8bbaf79e58066799Tim Reddehase# setting.

dcc3d62e5ee2d3f84edc1b0f8bbaf79e58066799Tim Reddehase

dcc3d62e5ee2d3f84edc1b0f8bbaf79e58066799Tim Reddehase#

dcc3d62e5ee2d3f84edc1b0f8bbaf79e58066799Tim Reddehase# Class to instantiate as the javax.security.auth.login.Configuration

dcc3d62e5ee2d3f84edc1b0f8bbaf79e58066799Tim Reddehase# provider.

dcc3d62e5ee2d3f84edc1b0f8bbaf79e58066799Tim Reddehase#

dcc3d62e5ee2d3f84edc1b0f8bbaf79e58066799Tim Reddehaselogin.configuration.provider=com.sun.security.auth.login.ConfigFile

dcc3d62e5ee2d3f84edc1b0f8bbaf79e58066799Tim Reddehase

d95c0de1fbdb66e2aa8d2dc223ad554413f1dc87Julian Kornberger#

# Default login configuration file

#

#login.config.url.1=file:${user.home}/.java.login.config

#

# Class to instantiate as the system Policy. This is the name of the class

# that will be used as the Policy object.

#

policy.provider=sun.security.provider.PolicyFile

# The default is to have a single system-wide policy file,

# and a policy file in the user's home directory.

policy.url.1=file:${java.home}/lib/security/java.policy

policy.url.2=file:${user.home}/.java.policy

# whether or not we expand properties in the policy file

# if this is set to false, properties (${...}) will not be expanded in policy

# files.

policy.expandProperties=true

# whether or not we allow an extra policy to be passed on the command line

# with -Djava.security.policy=somefile. Comment out this line to disable

# this feature.

policy.allowSystemProperty=true

# whether or not we look into the IdentityScope for trusted Identities

# when encountering a 1.1 signed JAR file. If the identity is found

# and is trusted, we grant it AllPermission.

policy.ignoreIdentityScope=false

#

# Default keystore type.

#

keystore.type=jks

#

# List of comma-separated packages that start with or equal this string

# will cause a security exception to be thrown when

# passed to checkPackageAccess unless the

# corresponding RuntimePermission ("accessClassInPackage."+package) has

# been granted.

package.access=sun.,\

com.sun.xml.internal.,\

com.sun.imageio.,\

com.sun.istack.internal.,\

com.sun.jmx.defaults.,\

com.sun.jmx.remote.util.,\

com.sun.org.apache.xerces.internal.utils.,\

com.sun.org.apache.xalan.internal.utils.,\

com.sun.org.glassfish.external.,\

com.sun.org.glassfish.gmbal.

#

# List of comma-separated packages that start with or equal this string

# will cause a security exception to be thrown when

# passed to checkPackageDefinition unless the

# corresponding RuntimePermission ("defineClassInPackage."+package) has

# been granted.

#

# by default, none of the class loaders supplied with the JDK call

# checkPackageDefinition.

#

package.definition=sun.,\

com.sun.xml.internal.,\

com.sun.imageio.,\

com.sun.istack.internal.,\

com.sun.jmx.defaults.,\

com.sun.jmx.remote.util.,\

com.sun.org.apache.xerces.internal.utils.,\

com.sun.org.apache.xalan.internal.utils.,\

com.sun.org.glassfish.external.,\

com.sun.org.glassfish.gmbal.

#

# Determines whether this properties file can be appended to

# or overridden on the command line via -Djava.security.properties

#

security.overridePropertiesFile=true

#

# Determines the default key and trust manager factory algorithms for

# the javax.net.ssl package.

#

ssl.KeyManagerFactory.algorithm=SunX509

ssl.TrustManagerFactory.algorithm=PKIX

#

# The Java-level namelookup cache policy for successful lookups:

#

# any negative value: caching forever

# any positive value: the number of seconds to cache an address for

# zero: do not cache

#

# default value is forever (FOREVER). For security reasons, this

# caching is made forever when a security manager is set. When a security

# manager is not set, the default behavior in this implementation

# is to cache for 30 seconds.

#

# NOTE: setting this to anything other than the default value can have

# serious security implications. Do not set it unless

# you are sure you are not exposed to DNS spoofing attack.

#

#networkaddress.cache.ttl=-1

# The Java-level namelookup cache policy for failed lookups:

#

# any negative value: cache forever

# any positive value: the number of seconds to cache negative lookup results

# zero: do not cache

#

# In some Microsoft Windows networking environments that employ

# the WINS name service in addition to DNS, name service lookups

# that fail may take a noticeably long time to return (approx. 5 seconds).

# For this reason the default caching policy is to maintain these

# results for 10 seconds.

#

#

networkaddress.cache.negative.ttl=10

#

# Properties to configure OCSP for certificate revocation checking

#

# Enable OCSP

#

# By default, OCSP is not used for certificate revocation checking.

# This property enables the use of OCSP when set to the value "true".

#

# NOTE: SocketPermission is required to connect to an OCSP responder.

#

# Example,

# ocsp.enable=true

#

# Location of the OCSP responder

#

# By default, the location of the OCSP responder is determined implicitly

# from the certificate being validated. This property explicitly specifies

# the location of the OCSP responder. The property is used when the

# Authority Information Access extension (defined in RFC 3280) is absent

# from the certificate or when it requires overriding.

#

# Example,

# ocsp.responderURL=http://ocsp.example.net:80

#

# Subject name of the OCSP responder's certificate

#

# By default, the certificate of the OCSP responder is that of the issuer

# of the certificate being validated. This property identifies the certificate

# of the OCSP responder when the default does not apply. Its value is a string

# distinguished name (defined in RFC 2253) which identifies a certificate in

# the set of certificates supplied during cert path validation. In cases where

# the subject name alone is not sufficient to uniquely identify the certificate

# then both the "ocsp.responderCertIssuerName" and

# "ocsp.responderCertSerialNumber" properties must be used instead. When this

# property is set then those two properties are ignored.

#

# Example,

# ocsp.responderCertSubjectName="CN=OCSP Responder, O=XYZ Corp"

#

# Issuer name of the OCSP responder's certificate

#

# By default, the certificate of the OCSP responder is that of the issuer

# of the certificate being validated. This property identifies the certificate

# of the OCSP responder when the default does not apply. Its value is a string

# distinguished name (defined in RFC 2253) which identifies a certificate in

# the set of certificates supplied during cert path validation. When this

# property is set then the "ocsp.responderCertSerialNumber" property must also

# be set. When the "ocsp.responderCertSubjectName" property is set then this

# property is ignored.

#

# Example,

# ocsp.responderCertIssuerName="CN=Enterprise CA, O=XYZ Corp"

#

# Serial number of the OCSP responder's certificate

#

# By default, the certificate of the OCSP responder is that of the issuer

# of the certificate being validated. This property identifies the certificate

# of the OCSP responder when the default does not apply. Its value is a string

# of hexadecimal digits (colon or space separators may be present) which

# identifies a certificate in the set of certificates supplied during cert path

# validation. When this property is set then the "ocsp.responderCertIssuerName"

# property must also be set. When the "ocsp.responderCertSubjectName" property

# is set then this property is ignored.

#

# Example,

# ocsp.responderCertSerialNumber=2A:FF:00

#

# Policy for failed Kerberos KDC lookups:

#

# When a KDC is unavailable (network error, service failure, etc), it is

# put inside a blacklist and accessed less often for future requests. The

# value (case-insensitive) for this policy can be:

#

# tryLast

# KDCs in the blacklist are always tried after those not on the list.

#

# tryLess[:max_retries,timeout]

# KDCs in the blacklist are still tried by their order in the configuration,

# but with smaller max_retries and timeout values. max_retries and timeout

# are optional numerical parameters (default 1 and 5000, which means once

# and 5 seconds). Please notes that if any of the values defined here is

# more than what is defined in krb5.conf, it will be ignored.

#

# Whenever a KDC is detected as available, it is removed from the blacklist.

# The blacklist is reset when krb5.conf is reloaded. You can add

# refreshKrb5Config=true to a JAAS configuration file so that krb5.conf is

# reloaded whenever a JAAS authentication is attempted.

#

# Example,

# krb5.kdc.bad.policy = tryLast

# krb5.kdc.bad.policy = tryLess:2,2000

krb5.kdc.bad.policy = tryLast

# Algorithm restrictions for certification path (CertPath) processing

#

# In some environments, certain algorithms or key lengths may be undesirable

# for certification path building and validation. For example, "MD2" is

# generally no longer considered to be a secure hash algorithm. This section

# describes the mechanism for disabling algorithms based on algorithm name

# and/or key length. This includes algorithms used in certificates, as well

# as revocation information such as CRLs and signed OCSP Responses.

#

# The syntax of the disabled algorithm string is described as this Java

# BNF-style:

# DisabledAlgorithms:

# " DisabledAlgorithm { , DisabledAlgorithm } "

#

# DisabledAlgorithm:

# AlgorithmName [Constraint]

#

# AlgorithmName:

# (see below)

#

# Constraint:

# KeySizeConstraint

#

# KeySizeConstraint:

# keySize Operator DecimalInteger

#

# Operator:

# <= | < | == | != | >= | >

#

# DecimalInteger:

# DecimalDigits

#

# DecimalDigits:

# DecimalDigit {DecimalDigit}

#

# DecimalDigit: one of

# 1 2 3 4 5 6 7 8 9 0

#

# The "AlgorithmName" is the standard algorithm name of the disabled

# algorithm. See "Java Cryptography Architecture Standard Algorithm Name

# Documentation" for information about Standard Algorithm Names. Matching

# is performed using a case-insensitive sub-element matching rule. (For

# example, in "SHA1withECDSA" the sub-elements are "SHA1" for hashing and

# "ECDSA" for signatures.) If the assertion "AlgorithmName" is a

# sub-element of the certificate algorithm name, the algorithm will be

# rejected during certification path building and validation. For example,

# the assertion algorithm name "DSA" will disable all certificate algorithms

# that rely on DSA, such as NONEwithDSA, SHA1withDSA. However, the assertion

# will not disable algorithms related to "ECDSA".

#

# A "Constraint" provides further guidance for the algorithm being specified.

# The "KeySizeConstraint" requires a key of a valid size range if the

# "AlgorithmName" is of a key algorithm. The "DecimalInteger" indicates the

# key size specified in number of bits. For example, "RSA keySize <= 1024"

# indicates that any RSA key with key size less than or equal to 1024 bits

# should be disabled, and "RSA keySize < 1024, RSA keySize > 2048" indicates

# that any RSA key with key size less than 1024 or greater than 2048 should

# be disabled. Note that the "KeySizeConstraint" only makes sense to key

# algorithms.

#

# Note: This property is currently used by Oracle's PKIX implementation. It

# is not guaranteed to be examined and used by other implementations.

#

# Example:

# jdk.certpath.disabledAlgorithms=MD2, DSA, RSA keySize < 2048

#

#

jdk.certpath.disabledAlgorithms=MD2

# Algorithm restrictions for Secure Socket Layer/Transport Layer Security

# (SSL/TLS) processing

#

# In some environments, certain algorithms or key lengths may be undesirable

# when using SSL/TLS. This section describes the mechanism for disabling

# algorithms during SSL/TLS security parameters negotiation, including cipher

# suites selection, peer authentication and key exchange mechanisms.

#

# For PKI-based peer authentication and key exchange mechanisms, this list

# of disabled algorithms will also be checked during certification path

# building and validation, including algorithms used in certificates, as

# well as revocation information such as CRLs and signed OCSP Responses.

# This is in addition to the jdk.certpath.disabledAlgorithms property above.

#

# See the specification of "jdk.certpath.disabledAlgorithms" for the

# syntax of the disabled algorithm string.

#

# Note: This property is currently used by Oracle's JSSE implementation.

# It is not guaranteed to be examined and used by other implementations.

#

# Example:

# jdk.tls.disabledAlgorithms=MD5, SHA1, DSA, RSA keySize < 2048

i