PingDirectory

Configuring PingDirectory server to disable the embedded administrative console

To decouple the embedded console from your PingDirectory Server instance, use dsconfig or the administrative console.

About this task

The Docker images on Docker Hub have the embedded console disabled by default. For more information on deploying the administrative console and the PingDirectory server with Docker, see Using Docker to run a standalone administrative console.

To configure a PingDirectory server that doesn’t have an embedded console running:

Steps

  1. Use dsconfig or the administrative console.

    Choose from:

    • To use dsconfig, run dsconfig set-connection-handler-prop.

      dsconfig set-connection-handler-prop \
    --handler-name "<HTTPS Connection Handler>"  \
    --reset web-application-extension

      Replace <HTTPS Connection Handler> with the name of the connection handler hosting the administrative console.

    • To use the administrative console, open the console:

      1. From the Configuration page, go to Connection Handlers.

      2. In the Connection Handlers list, select the HTTP or HTTPS connection handler that is hosting the administrative console.

      3. Go to Web Application Extension and click the arrows to move Console from the Selected column on the right to the Available column on the left.

  2. To finalize your changes, restart the HTTPS connection handler using dsconfig.

    Example:

    dsconfig set-connection-handler-prop \
    --handler-name "<HTTPS Connection Handler>" \
    --set enabled:false

dsconfig set-connection-handler-prop \
    --handler-name "<HTTPS Connection Handler>" \
    --set enabled:true