PingOne

Starting a gateway instance as a standalone Java application

Download a gateway bundle and run it on a local computer as a Java application.

Before you begin

Ensure that you have Java 17 or Java 21 installed.

About this task

Run the application on a computer that can reach your LDAP directory and PingOne.

Steps

  1. Go to Integrations → Gateways and locate the appropriate gateway.

  2. Click the gateway name to expand the gateway details.

  3. Click the Download tab.

  4. In the Standalone section, review the prerequisites and instructions.

  5. In the Instructions section, click the download link for the gateway bundle.

    If promted, complete the sign-on process.

    Result:

    The download begins

  6. To configure the gateway, extract the downloaded bundle and follow the instructions in the README.txt file.

  7. Optional: To configure an LDAP Gateway client application to use a forward web proxy server to handle WebSocket traffic between the gateway and PingOne, update the run.properties file.

    • To add the web proxy details after installing the LDAP gateway client application as a Windows service, update the run.properties file, and then run the bin/windows/reinstall-service.bat file.

    • You must configure the web proxy settings locally per each running instance. For example, if you’re running two gateway client applications, you must configure web proxy settings in both instances.

Next steps

Verify a gateway instance