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

  • If you have a valid gateway credential, have it ready. Alternatively, you can create a new credential on the Overview tab in the gateway details. Learn more in Creating or deleting a gateway credential.

  • Install Java version 17.0.8 or later or Java version 21 LTS or later on the computer that will run the gateway.

  • Create a JAVA_HOME system environment variable that points to the directory that contains the bin directory from the Java distribution.

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. Follow the instructions in the README.txt file to configure the run.properties file, including providing the gateway credential information.

  7. Optional: To configure an LDAP Gateway client application to use a forward web proxy server to handle traffic between the gateway and PingOne, provide access information into the run.properties 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.

    • Digest authentication does not support international characters.

    • Basic authentication requires configuration in the proxy server to support international characters.

  8. Sign on to the computer with administrator privileges.

  9. At a command prompt, run the bin\run.bat file for Windows or the bin/run.sh file for Linux.

Next steps