How to Override Java Security Configuration per JVM Instance

>> Saturday, November 24, 2012


Lately I encountered a configuration tweak I was not aware of, the problem: I had a single Java installation on a Linux machine from which I had to start two JVM instances - each using a different set of JCE providers. A reminder: the JVM loads its security configuration, including the JCE providers list, from a master security properties file within the JRE folder (JRE_HOME/lib/security/, the location of that file is fixed in the JVM and cannot be modified. Going over the documentation (not too much helpful, I must admit) and the code (more helpful, look for, for example here) reveled the secret.


It all starts within the default file provided with the JVM, looking at it we will find the following (somewhere around the middle of the file)
# Determines whether this properties file can be appended to
# or overridden on the command line via

If the overridePropertiesFile doesn’t equal to true we can stop here - the rest of this article is irrelevant (unless we have the option to change it – but I didn’t have that). Lucky to me by default it does equal to true.

Next step, the interesting one, is to override or append configuration to the default file per JVM execution. This is done by setting the '' system property to point to a properties file as part of the JVM invocation; it is important to notice that referencing to the file can be done in one of two flavors:
  1. Overriding the entire file provided by the JVM - if the first character in the' value is the equals sign the default configuration file will be entirely ignored, only the values in the file we are pointing to will be affective
  2. Appending and overriding values of the default file - any other first character in the property's value (that is the first character in the alternate configuration file path) means that the alternate file will be loaded and appended to the default one. If the alternate file contains properties which are already in the default configuration file the alternate file will override those properties.
Here are two examples
# Completely override the default file content
# (notice the *two* equal signs) 

# Append or override parts of the default file
# (notice the *single* equal sign)

Be Carefull

As an important configuration option as it is we must not forget its security implications. We should always make sure that no one can tamper the value of the property and that no one can tamper the alternate file content if he shouldn't be allowed to.


Anonymous September 25, 2013 at 11:48 PM  

Interesting, would it work in conjunction with "-Djava.endorsed.dirs" so that I can have my bouncycastle provider jar outside of jre/lib/ext directory?

Eyal Lupu September 26, 2013 at 1:26 AM  

I cannot remember if the endorsed folder is supported for JCE providers - but if so I don't see a reason why you cannot combine the two.
The best is probably to give it a try

Anonymous September 26, 2013 at 1:41 AM  

It works with -Djava.ext.dirs:


Naresh October 10, 2013 at 10:54 AM  

For some reason, I cannot get this to work. That is, override a property by specifying it in a custom properties file and providing the location via the parameter.

Keep getting the default value specified in file.

I couldn't get this to work in JDK 1.6_32, 1.7.0_25, 1.7.0_40.

Eyal Lupu October 11, 2013 at 1:04 AM  

Make sure you are setting the property (-D) before the main class name.

Mary Brown May 26, 2014 at 3:46 AM  

Can we use java.util.Properties class

Java Training in Chennai

seveneleven September 24, 2014 at 12:14 AM  

thank you for sharing...

equestions December 11, 2014 at 6:24 PM  

Eyal, My purpose is really to eliminate overriding. So I plan to change that the default 'true' value to 'false'. For local connections that is sufficient to prevent overriding of system properties. However, that does not work for remote connections using RMI. Any advice with respect to RMI? Thanks!

christina jeni December 22, 2014 at 1:33 AM  

Thanks for sharing this informative blog about Java. Your information is really useful for Java begginer. I wish to be a regular contributor of your blog, can you please update your blog with advanced Java techniques. Java is one of the popular technologies with improved job opportunity for hopeful professionals. Training on java helps you to study this technology in feature. Those who want to become a Java developer in a short period of time reach FITA, which offer best Java Training in Chennai with years of experienced professionals.

  © Blogger templates Sunset by 2008

Back to TOP