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
-
Go to Integrations → Gateways and locate the appropriate gateway.
-
Click the gateway name to expand the gateway details.
-
Click the Download tab.
-
In the Standalone section, review the prerequisites and instructions.
-
In the Instructions section, click the download link for the gateway bundle.
If promted, complete the sign-on process.
Result:
The download begins
-
Follow the instructions in the
README.txt
file to configure therun.properties
file, including providing the gateway credential information. -
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.
-
-
Sign on to the computer with administrator privileges.
-
At a command prompt, run the
bin\run.bat
file for Windows or thebin/run.sh
file for Linux.