PingDirectory

Using the Configuration API

The PingDirectory server provides a Configuration API when updating the server configuration with LDAP is not possible. The API is consistent with the System for Cross-domain Identity Management (SCIM) 2.0 protocol and uses JSON as a text exchange format, so all request headers allow the application/json content type.

About this task

The server includes a servlet extension that provides read and write access to the server’s configuration over HTTP.

Steps

  • To add the extension to one of the server’s HTTP Connection Handlers, run the following code.

    $ bin/dsconfig set-connection-handler-prop \
      --handler-name "HTTPS Connection Handler" \
      --add http-servlet-extension:Configuration

    By default, the extension is enabled for new installations. You can enable the extension for existing deployments.

    Result:

    The API is made available on the HTTPS Connection Handler’s host:port in the /config context. Because of the potentially sensitive nature of the server’s configuration, use the HTTPS Connection Handler for hosting the configuration extension.