AM 7.5.0

Prepare a configuration store

This page explains how to prepare a single DS server as an external configuration data store. Make sure DS replicas use the same configuration.

Installing DS with a DS setup profile creates the required backend, schema, bind user, and indexes:

  1. Follow the steps in Install DS for AM configuration in the Directory Services documentation.

  2. Install AM to use the prepared DS directory server as an external configuration store.

    The default bind DN of the service account to connect to the external configuration store is:

  3. Share the configuration store certificate with the AM container to prepare for TLS/LDAPS.

    AM should communicate with the configuration store over a secure connection.

    From DS 7 onwards, secure connections are required by default; therefore, share the DS certificate with the AM container before continuing.

    1. Export the DS server certificate:

      $ keytool -exportcert \
      -keystore /path/to/opendj/config/keystore \
      -storepass:file /path/to/opendj/config/ \
      -alias ssl-key-pair \
      -rfc \
      -file ds-cert.pem

      The default DS server certificate only has the hostname you supplied at setup time, and localhost, as the value of the SubjectAlternativeName attribute; however, certificate hostname validation is strict. Ensure that the certificate matches the hostname (or the FQDN) of the DS server before continuing.

      Copy the ds-cert.pem file to an accessible location on the AM host.

    2. Import the DS certificate into the AM truststore:

      $ keytool \
      -importcert \
      -file ds-cert.pem \
      -keystore /path/to/openam/security/keystores/truststore

      For more information on configuring AM’s truststore, refer to Prepare the truststore.

When the certificate is in place, continue installing AM.

After setting up the external configuration store, you can enhance security by configuring mTLS authentication to that store and rotating the mTLS certificates periodically. For details, refer to mTLS for configuration stores.
Copyright © 2010-2024 ForgeRock, all rights reserved.