If your application is a Java servlet or a Java application, use o4glrt.jar as the Open Client runtime package. This package supports the following protocols:

  • HTTP
  • HTTPS

These protocols are supported over the intranet and internet. The o4glrt.jar Open Client runtime package supports user-implemented authentication to a web server and proxy server.

The Java Open Client runtime package o4glrt.jar supports most TLS-enabled web servers. The TLS configuration for the individual web server and the digital certificate used to authenticate the identity of the web server determines whether you can use this package.

This package supports user-implemented authentication to a web server, data encryption, and Proxy server.

As you develop your HTTPS applications, you should consider that the application deployer might require certain data encryption and digital signature algorithms when they configure their web servers.

If you are using Progress Developer Studio for OpenEdge, you will also need to copy the following third-party Apache Tuscany jar files to the same directory where you copy the Java Open Client Runtime package you selected. These files reside in the specified OpenEdge installation directory, as shown:

OpenEdge-install-directory/java/
      messages.jar
      ehnlog.jar 
OpenEdge-install-directory/java/oe
      oeauth-<version>.jar 
OpenEdge-install-directory/java/ext/
      common-<version>.jar
      commons-codec-<version>.jar
      commons-logging-<version>.jar
      ecore-<version>.jar
      ecore-change-<version>.jar
      ecore-xmi-<version>.jar
      httpclient-<version>.jar
      httpasyncclient-<version>.jar  
      httpcore-<version>.jar
      httpcore-nio-<version>.jar
      tuscany-sdo-api-r2.1-<version>.jar
      tuscany-sdo-impl-<version>.jar
      tuscany-sdo-lib-<version>.jar
      tuscany-sdo-tools-<version>.jar
      xsd-<version>.jar

The following table lists the security supported by various Open Client Runtime packages.

Table 1. Security supported by package
Package Supported security
HTTP
  • Authentication that includes:
    • User-implemented authentication using a userid and password passed to the application server's connect procedure
    • Basic authentication to the web server
  • Proxy servers
    • Basic Proxy server authentication

To set HTTP connection properties on the Java Open Client (such as proxy host, port, and credentials), see Alphabetical list of properties.
HTTPS
  • Authentication that includes:
    • User-implemented authentication using a userid and password passed to the application server's connect procedure
    • Basic Proxy server authentication
    • HTTP basic authentication to the web server
  • Proxy servers
    • Basic Proxy server authentication
  • TLS support is dependent on the client and server JVMs. OpenEdge supports SSLv3 and TLS versions 1.2 and 1.3.

For more information about TLS support, see Supported protocols, cipher, and certificates for OpenEdge client and servers, Configure TLS server sessions, and Configure TLS client sessions.

To set HTTPS and TLS connection properties on the Java Open Client (such as certificate store location, host verification, and SSL session reuse), see Alphabetical list of properties.