Use operating system provided trust store with Java Open Client
- Last Updated: November 11, 2026
- 2 minute read
- OpenEdge
- Version 13.1
- Documentation
Starting with OpenEdge 13.1, Java Open Client uses the operating system (OS) provided trust store by default as the source of trusted CA root certificates for TLS certificate chain validation.
When the OS trust store is active, any explicitly-configured trust store properties such as,
certPath, certStoreProvider,
certStoreType, certStorePassword are ignored. CA
root certificates are read exclusively from the OS-managed certificate store.
How the trust store is determined
The mechanism used to select the active trust store depends on whether the OpenEdge installation directory path is configured for the Java Open Client:
-
No installation directory path configured—The trust store is controlled by the
OENativeTrustStoreproperty, which is set tofalseby default, implying that the OS trust store is used. -
Installation directory path configured—The trust store is controlled by the
$DLC/properties/TLSPolicy.cnfpolicy file. The relevant parameter is:Install.JOC.defaultTruststore=0 # OS Trust Store (default) Install.JOC.defaultTruststore=1 # OpenEdge native trust storeIf the policy file is absent or corrupted for any reason, the OS trust store is used as the fallback.
For more information, see Trust store policy file.
Java Open Client inherits only the resulting configuration value and not the policy semantics, governance responsibilities, or enforcement behavior associated with the referenced installation.
Add CA certificates to the OS trust store
- For Windows, see Use OS-provided certificate store on Windows.
- For Linux, see Use OS-provided certificate store on Linux.
How Java Open Client accesses the OS trust store
On Windows, Java Open Client uses the SunMSCAPI security provider to access the Windows
Certificate Store. Java Open Client is configured to use the
Windows-ROOT keystore type, that maps to the Local Machine
Trusted Root Certification Authorities store, which is the machine-level store
shared by all users and services on the computer. Because Java Open Client uses
Windows-ROOT, CA certificates must be installed in the Local
Machine Trusted Root Certification Authorities store to be found by Java Open
Client.
On Linux, Java Open Client uses a custom provider named LinuxOSTruststore to
read CA certificates from the standard system CA trust store location for the host
Linux distribution and assembles them into an in-memory keystore for use during TLS
connections. You must include oelinuxtruststoreprovider-13.1.0.jar
(located at $DLC/java/oe) in the classpath when using the OS trust
store.