Identity Cloud

User registration

While this use case was validated for accuracy, it can always be improved. To provide feedback, click thumb_up or thumb_down in the top right of this page (you must be logged into Backstage).

Description

Estimated time to complete: 20 minutes

In this use case, you test the default registration journey to observe how it works. Then, you duplicate it and make changes to meet your organization’s needs. Finally, you register as a new end user using the updated registration journey.

Goals

After completing this use case, you will know how to create a new user registration journey.

Prerequisites

Before you start work on this use case, ensure you have these prerequisites:

  • Access to your Identity Cloud development environment as an administrator.

  • A basic understanding of journeys and nodes.

Tasks

Task 1: Test the default registration journey

  1. In the Identity Cloud admin UI, go to account_tree Journeys and click on the Registration journey.

  2. In the Preview URL field, click copy and paste the URL into an Incognito window.

    The Sign Up page for the tenant displays.

  3. In the Sign Up page, enter the following details:

    Field Value

    Username

    asmith

    First Name

    Amy

    Last Name

    Smith

    Email Address

    asmith@example.com

    Password

    Ch4ng3it!

    Select a security question

    Select What’s your favorite color?

    Answer

    Red

  4. Click Next.

    You are logged into the Identity Cloud End User UI as Amy Smith.

  5. Close the Incognito window and go back to the Identity Cloud admin UI.

  6. Go to people Identities > Manage.

  7. Enter asmith in the Search field and press Enter.

    The user asmith displays with the details you entered above:

    Confirm the new user

Task 2: Modify the default registration journey

  1. In the Identity Cloud admin UI, go to account_tree Journeys.

  2. On the Journeys page, click the ellipsis icon () for the Registration journey and select Duplicate.

  3. In the Duplicate Journey window, enter the following details:

    Field Value

    Name

    User Registration

    Identity Object

    Alpha realm - Users managed/alpha_user

    Description

    Updated user registration journey.

  4. Click Save.

    The journey editor displays.

  5. In the journey editor, select the KBA Definition node in the Page Node and click delete to delete this node.

    This removes the security questions from the registration process.

  6. Search for the Email Suspend Node and drag it on to the journey canvas.

    The Email Suspend Node sends an email to the end user and only resumes the journey once they click a link in the email. In this case, they confirm their email address.

  7. Select the Platform Password node in the Page Node and drag it out of the node on to the journey canvas.

  8. Connect the Page Node outcome to the Email Suspend Node input.

  9. Connect the Email Suspend Node outcome to the Platform Password node input.

  10. Click the Email Suspend Node and review the default settings. You do not need to modify them.

    Email Suspend Node settings

    The Email Template Name field shows which email template is used in the journey.

  11. Connect the Platform Password node outcome to the Create Object node input.

  12. Click Save.

Check in
Updated user registration journey

At this point, the journey is configured to:

  • a Collect the username, user details, terms and conditions, and present it on the same page.

  • b Email the end user so they can confirm their email address.

  • c Once confirmed, collect the end user’s password.

  • d Create the new identity in Identity Cloud.

  • e Increment the successful login count property for the end user.

Task 3: Check journey path connections

Use the following table to check the outcomes for each node in the User Registration journey.

Many nodes can have more than one outcome. "→" denotes that a node only has one outcome path.

Source node Outcome path Target node

Start (person icon)

→

Page Node

Page Node containing:

  • Platform Username

  • Attribute Collector

  • Accept Terms and Conditions

→

Email Suspend Node

Email Suspend Node

→

Platform Password

Platform Password

→

Create Object

Create Object

Created

Increment Login Count

Failed

Failure

Increment Login Count

→

Success

Validation

Now that you have created a new user registration journey, you are ready to validate your journey.

The steps in this validation register a new end user in Identity Cloud so you can verify the new User Registration journey.

When you register the new end user, ensure you use an email address that you can access.

Steps

  1. In the Identity Cloud admin UI, go to account_tree Journeys and click on the User Registration journey you just updated.

  2. In the Preview URL field, click copy and paste the URL into an Incognito window.

    The Sign Up page for the tenant displays.

  3. In the Sign Up page, enter the following details:

    Field Value

    Username

    agarcia

    First Name

    Alex

    Last Name

    Garcia

    Email Address

    Enter an email address for this new end user. You must have access to this email account.

  4. Click Next. A message displays informing you an email has been sent.

  5. Click the link in the Registration email to confirm your email address and continue registration.

  6. Enter Ch4ng3it! in the Password field.

  7. Click Next.

    You are logged into the Identity Cloud End User UI as Alex Garcia.

  8. Close the Incognito window and go back to the Identity Cloud admin UI.

  9. Go to people Identities > Manage.

  10. Enter agarcia in the Search field and press Enter.

    The user agarcia displays with the details you entered above.

Video of validation

The following video displays the expected validation of registering a new end user using the updated registration journey:

Explore further

Reference material

Reference Description

Registration

Information about the default registration journey.

Journeys

Conceptual information on journeys and their purpose in Identity Cloud.

Nodes for journeys

Learn about the configurable nodes Identity Cloud offers for use in journeys.

Manage identities

Manage, group, and assign privileges to identities.

Nodes used

The User Registration journey uses the following nodes:

Copyright © 2010-2024 ForgeRock, all rights reserved.