Shared identity store

This is not a comprehensive platform implementation guide. These sample setup instructions show a minimal integration of platform components to get you started.

The Ping Identity Platform offers maximum extensibility and flexibility in self-managed deployments. The platform includes many features and options these sample setup instructions do not cover. If you don’t need maximum extensibility and flexibility, there are simpler alternatives:

To consume the platform as a service, use PingOne Advanced Identity Cloud.
To deploy in Kubernetes, start with the ForgeOps reference implementation.

For help with your deployment and to validate your plans before deploying in production, contact Ping Identity.

This sample deployment uses a single external PingDS server as:

The PingAM configuration store.
The PingAM identity store.
The PingIDM identity store.

The PingIDM End User UI is not supported in a platform deployment, as it does not support authentication through PingAM.

You can use the Set up the platform UIs with this deployment, or create your own UIs that support authentication through PingAM.

Download PingDS

Follow the instructions in the PingDS documentation to download PingDS, and prepare for installation.

The instructions that follow assume you download the cross-platform .zip distribution.

Set up PingDS

Unpack the PingDS files you downloaded.
Generate and save a unique PingDS deployment ID:
```
/path/to/opendj/bin/dskeymgr create-deployment-id --deploymentIdPassword password
```
You will need the deployment ID and password to install PingDS, and to export the server certificate.

Set the deployment ID in your environment:
```
export DEPLOYMENT_ID=deployment-id
```

Install a PingDS server with the necessary setup profiles:

am-config
am-cts
am-identity-store
idm-repo

For more information about PingDS setup profiles, refer to setup profiles in the PingDS documentation.

/path/to/opendj/setup \
--deploymentId $DEPLOYMENT_ID \
--deploymentIdPassword password \
--rootUserDN uid=admin \
--rootUserPassword str0ngAdm1nPa55word \
--monitorUserPassword str0ngMon1torPa55word \
--hostname directory.example.com \
--adminConnectorPort 4444 \
--ldapPort 1389 \
--enableStartTls \
--ldapsPort 1636 \
--profile am-config \
--set am-config/amConfigAdminPassword:5up35tr0ng \
--profile am-cts \
--set am-cts/amCtsAdminPassword:5up35tr0ng \
--set am-cts/tokenExpirationPolicy:am-sessions-only \
--profile am-identity-store \
--set am-identity-store/amIdentityStoreAdminPassword:5up35tr0ng \
--profile idm-repo \
--set idm-repo/domain:forgerock.io \
--acceptLicense

For simplicity, this sample deployment uses a standalone directory server that:

Does not replicate directory data (no --replicationPort or --bootstrapReplicationServer options).

In production deployments, always replicate directory data for availability and resilience.
Consolidates all directory data in the same replicas.

In very high-volume production deployments, test whether this meets your performance requirements and adjust your directory deployment if necessary.
Keeps PingAM identity data and PingIDM repository data under distinct base DNs.

Both PingAM and PingIDM expect exclusive access to their data. Keep their data separate with distinct base DNs and domains in your setup profiles. Don’t accidentally mix their data by choosing a base DN under the other base DN.

For details, refer to the PingDS installation documentation.

Start the PingDS server:
```
/path/to/opendj/bin/start-ds
```

Set up a container

Install a Java container to deploy PingAM.

These deployment examples assume you’re using Apache Tomcat:

Follow the instructions in the PingAM documentation to prepare your environment.
Use a supported version of Apache Tomcat as the web application container:
1. Configure Tomcat to listen on port 8081.
  
  This non-default port requires that you update Tomcat’s conf/server.xml file. Instead of the default line, <Connector port="8080" protocol="HTTP/1.1">, use:
  <Connector port="8081" protocol="HTTP/1.1">
2. Create a Tomcat bin/setenv.sh or bin\setenv.bat file to hold your environment variables.
3. Follow the instructions in the PingAM documentation to prepare Tomcat as the web application container.

You can find complete instructions on setting up Tomcat in the PingAM documentation.

Secure connections

From PingDS 7 onwards, you must secure connections to PingDS servers.

Create a new directory that will house a dedicated truststore for PingAM:
```
mkdir -p /path/to/openam-security/
```
Export the PingDS server certificate.

You must run this command on directory.example.com in the terminal window where you set the DEPLOYMENT_ID variable:
```
/path/to/opendj/bin/dskeymgr export-ca-cert \
--deploymentId $DEPLOYMENT_ID \
--deploymentIdPassword password \
--outputFile ds-ca-cert.pem
```

Import the PingDS server certificate into the dedicated PingAM truststore.

If you’re not testing this example on a single host, you might need to copy each certificate file onto the PingAM host machine first:

keytool \
-importcert \
-trustcacerts \
-alias ds-ca-cert \
-file /path/to/ds-ca-cert.pem \
-keystore /path/to/openam-security/truststore \
-storepass changeit \
-storetype JKS
Owner: CN=Deployment key, O=ForgeRock.com
Issuer: CN=Deployment key, O=ForgeRock.com
...
Trust this certificate? [no]:  yes
Certificate was added to keystore

List the certificates in the new truststore and verify that the certificate you added is there:
```
keytool \
-list \
-keystore /path/to/openam-security/truststore \
-storepass changeit
```
Point Apache Tomcat to the path of the new truststore so that PingAM can access it.

Append the truststore settings to the CATALINA_OPTS variable in the Tomcat bin/setenv.sh file; for example:
```
CATALINA_OPTS="-Djavax.net.ssl.trustStore=/path/to/openam-security/truststore \
-Djavax.net.ssl.trustStorePassword=changeit \
-Djavax.net.ssl.trustStoreType=jks"
```
Refer to your specific container’s documentation for information on configuring truststores.

Verify secure authentication to the PingDS server with the dedicated PingAM accounts.

If you deployed PingAM and PingDS on separate computers, first copy the PingAM truststore to /path/to/openam-security/truststore on the computer where PingDS runs. Use the PingDS ldapsearch command to connect to PingDS using the local copy of the PingAM truststore:

/path/to/opendj/bin/ldapsearch \
--hostname directory.example.com \
--port 1636 \
--useSsl \
--useJavaTrustStore /path/to/openam-security/truststore \
--trustStorePassword changeit \
--bindDn uid=am-config,ou=admins,ou=am-config \
--bindPassword 5up35tr0ng \
--baseDn ou=am-config \
"(&)" \
1.1
dn: ou=am-config

dn: ou=admins,ou=am-config

dn: uid=am-config,ou=admins,ou=am-config

/path/to/opendj/bin/ldapsearch \
--hostname directory.example.com \
--port 1636 \
--useSsl \
--useJavaTrustStore /path/to/openam-security/truststore \
--trustStorePassword changeit \
--bindDn uid=am-identity-bind-account,ou=admins,ou=identities \
--bindPassword 5up35tr0ng \
--baseDn ou=identities \
"(&)" \
1.1
dn: ou=identities

dn: ou=people,ou=identities

dn: ou=groups,ou=identities

dn: ou=admins,ou=identities

dn: uid=am-identity-bind-account,ou=admins,ou=identities

Ping Identity Platform

Shared identity store

Download PingDS

Set up PingDS

Set up a container

Secure connections

Next step