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 OENativeTrustStore property, which is set to false by default, implying that the OS trust store is used.

  • Installation directory path configured—The trust store is controlled by the $DLC/properties/TLSPolicy.cnf policy file. The relevant parameter is:

    Install.JOC.defaultTruststore=0   # OS Trust Store (default)
    Install.JOC.defaultTruststore=1   # OpenEdge native trust store

    If 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

If your deployment uses custom or internal CA certificates, add them to the OS trust store on each host where Java Open Client runs:
Note: On platforms other than Windows and Linux and on unsupported Linux distribution, the OS trust store is not supported. To ensure TLS connections succeed with custom CA certificates in these environments, enable the OpenEdge native trust store and provide a certificate store file with the required CA certificates.

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.