Adding the LDAP gateway service
Download the .zip
archive and extract it to the computer that will run the gateway.
Steps
-
In the PingOne admin console, 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 prompted, complete the sign-on process.
Result:
The download begins.
-
Extract the
.zip
archive to the computer that will run the gateway.We recommend that you use a common location as the parent directory, such as
C:\Program Files\Ping Identity
. -
Follow the instructions in the
README.txt
file to configure therun.properties
file, including providing the gateway credential information.The
run.properties
file is located in theconfig
directory. For example:C:\Program Files\Ping Identity\pingone-ldap-gateway-2.3.0\config
. -
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.-
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 thebin/windows/reinstall-service.bat
file using an account with administrator privileges. -
You must also 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 Windows with administrator privileges.
-
Start a command prompt or PowerShell.
-
Run the
install-service.bat
file without any parameters.By design, the
install-service.bat
file does not start the service automatically after completion. However, the service is configured to start automatically at the next and subsequent restarts of the Windows operating system. -
In the Services system application, start the PingOne LDAP Gateway service.