PingDirectory

Signing on to the administrative console

After you install the server, access the administrative console to verify the configuration and manage the server.

To access the administrative console, go to https://<host>:<port>/console/login.

<host> is the hostname of the server, and <port> is the port on which the server accepts connections from HTTPS clients. You configured this during installation.

The <port> is different for PingDirectory and each of its add-ons. The console that you access is specific to the add-on you are using.

The root user distinguished name (DN) or the common name of a root user DN is required to sign on to the administrative console. For example, if the DN created when the server was installed is cn=Directory Manager, directory manager can be used to sign on to the administrative console.

To set up an SSO connection to the administrative console, see Single sign-on with the PingDirectory server administrative console.

To run the administrative console in an external container, such as Tomcat, see Deploying the administrative console.

Setting the administrative console session timeout window

The default session timeout for the administrative console is 24 hours. You can adjust your session length to suit your organization’s needs.

About this task

When the session duration is exceeded, all inactive users are logged off automatically.

To change the default session timeout value:

Steps

  1. To configure the server.sessionTimeout application parameter, which specifies the timeout duration in seconds, set the value as an init parameter either in the console or on the command line.

    Choose from:

    • Use the administrative console:

      1. Ensure that the Show Advanced Configuration check box is selected.

        A screen capture of the administrative console configuration screen with the Show Advanced Configuration check box selected.
      2. In the Web Services and Applications list, select Web Application Extensions.

      3. In the Web Application Extension list, select Console.

      4. In the Init Parameter field, enter the desired timeout duration value in seconds.

      5. Click Save.

    • Use the command line:

    • Run the following command:

      dsconfig set-web-application-extension-prop --no-prompt \
      --extension-name Console \
      --add init-parameter:server.sessionTimeout=<value in seconds>
  2. To save your changes, restart the HTTP(S) Connection Handler or the server.

    Choose from:

    • Restart the HTTP(S) Connection Handler:

      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
    • Restart the server using bin/stop-server with the -R or --restart option:

      bin/stop-server --restart