Configuring User Self-Service

You can configure the user self-service features to use email address verification, which sends an email containing a link for user self-registration and forgotten password reset via AM's Email Service. You can also send the forgotten username to the user by email if configured.


To configure user self-registration and password recovery in the ForgeRock Identity Platform, see the ForgeRock Identity Platform Self-Service Guide.

The following table summarizes the high-level tasks required to configure the user self-service features:


Create Encryption and Signing Keys

The user self-service features require a key pair for encryption and a signing secret key. Create one of each for each instance of user self-service you plan to configure.

Configure a User Self-Service Instance

Each realm requires its own instance.

Configure User Self-Service Security

Configure at least one security method for each feature:

  • Configure the email service to send an email to users that are registering, or users that are resetting their passwords.

  • Configure knowledge-based questions that users must answer to reset their passwords.

  • Configure Google reCAPCHA to protect any of the user self-service features from bots.

Configure User Self-Service Features

Configure the features that your environment requires.

Creating a User Self-Service Service Instance
  1. In the AM console, go to Realms > Realm Name > Services and select Add a Service.

  2. Select User Self-Service from the list of possible services.

  3. Populate the values of the Encryption Key Pair Alias and the Signing Secret Key Alias properties with the names of the key pair aliases in your JCEKS keystore. Note that the name of the demo keys shows with a gray color; that does not mean the fields are filled in.

    For example, if you are using the demo keys in the default keystore.jceks file, set the properties as follows:

    • Encryption Key Pair Alias to selfserviceenctest.

    • Signing Secret Key Alias to selfservicesigntest.


      The demo key aliases are for test or evaluation purposes. Do not use them in production environments. To create new key aliases, see "To Create Self-Service Key Aliases".

  4. (Optional) Enable the user self-service features.

  5. Select Create.

Read a different version of :