If you need to use the OpenEdge native trust store behavior—reading CA certificates from psccerts.jar, psccerts.zip, or an explicitly configured certificate store directory—set the OENativeTrustStore property. When enabled, the OS trust store is bypassed and the certPath, certStoreProvider, certStoreType, and certStorePassword trust store properties are honored.

Note: When using the OpenEdge native trust store, CA root certificates must be present in the configured certificate store—$DLC/certs/psccerts.jar by default, or the path specified by certPath. If your CA certificates are only in the OS trust store and not in the OpenEdge-specific store, TLS connections will fail on enabling the OENativeTrustStore property.

Setting the native trust store depends on whether the OpenEdge installation directory path is configured for the Java Open Client:

  • No installation directory path configured—You can set the OENativeTrustStore property:
    • At the connection level
    • Via run-time properties
    • As a JVM system property
    The following example demonstrates how to set OENativeTrustStore at the connection level or via run-time properties:
    import com.progress.open4gl.javaproxy.Connection;
    
    public class Example 
    {
        public static void main(String[] args) throws Exception
        {  
            
    
           // Option 1: set via RunTimeProperties
            RunTimeProperties.setOENativeTrustStore(true); 
    
            Connection connection = new Connection(
                "https://example:8080/apsv", "", "", "");
    
            // Option 2: set at the connection level
            connection.setOENativeTrustStore(true);
    
        }
    }

    The following command-line example demonstrates how to set this property at startup:

    java <other options> -classpath <path to JAR file> \
    	-DPROGRESS.Session.OENativeTrustStore=true
  • Installation directory path configured—Edit $DLC/properties/TLSPolicy.cnf and set the Install.JOC.defaultTruststore parameter to 1:

    Install.JOC.defaultTruststore=1

    This setting instructs Java Open Clients to use the OpenEdge native trust store ($DLC/certs/psccerts.jar) for all connections.

    If the policy file is absent or corrupted for any reason, the OS trust store is used as the fallback. For more information about the policy file, see Trust store policy file.