--- title: User registration description: "Estimated time to complete: 20 minutes" component: pingoneaic page_id: pingoneaic:use-cases:use-case-user-registration canonical_url: https://docs.pingidentity.com/pingoneaic/use-cases/use-case-user-registration.html keywords: ["Implementation Guide", "Use Case", "Journeys", "Self-Service", "Setup & Configuration"] page_aliases: ["implementation:use-case-user-registration.adoc"] section_ids: user-registration-description: Description user-registration-goals: Goals user-registration-prereqs: Prerequisites user-registration-tasks: Tasks user-registration-task-1: "Task 1: Test the default registration journey" user-registration-task-2: "Task 2: Modify the default registration journey" user-registration-task-3: "Task 3: Check journey path connections" user-registration-validation: Validation user-registration-validation-steps: Steps user-registration-video-validation: Video of validation user-registration-explore-further: Explore further user-registration-reference-material: Reference material user-registration-nodes-used: Nodes used --- # User registration ## Description Estimated time to complete: 20 minutes *(tooltip: This assumes you complete the prerequisites beforehand.)* 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. | | | | - | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | To quickly test this user registration journey without building it from scratch, you can download it from the Ping Identity Marketplace. Learn more in [User Registration Journey](https://marketplace.pingone.com/item/user-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 Advanced 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 Advanced Identity Cloud admin console, go to [icon: account_tree, set=material, size=inline] Journeys and click on the Registration journey. 2. In the Preview URL field, click [icon: copy, set=material, size=inline] 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 signed on to the hosted account pages as Amy Smith. 5. Close the incognito window and go back to the Advanced Identity Cloud admin console. 6. Go to [icon: people, set=material, size=inline] 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](_images/use-case-user-registration/test-registration-journey.png) ### Task 2: Modify the default registration journey 1. In the Advanced Identity Cloud admin console, go to [icon: account_tree, set=material, size=inline] Journeys. 2. On the Journeys page, click the ellipsis icon ([icon: ellipsis-h, set=fa]) 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 [icon: delete, set=material, size=inline] 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](_images/use-case-user-registration/email-suspend-node.png) 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](_images/use-case-user-registration/updated-registration-journey.png) 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 Advanced 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 Advanced 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 Advanced Identity Cloud admin console, go to [icon: account_tree, set=material, size=inline] Journeys and click on the `User Registration` journey you just updated. 2. In the Preview URL field, click [icon: copy, set=material, size=inline] 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 signed on to the hosted account pages as Alex Garcia. 8. Close the incognito window and go back to the Advanced Identity Cloud admin console. 9. Go to [icon: people, set=material, size=inline] 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: **Video (Brightcove)** \ ## Explore further ### Reference material | Reference | Description | | --------------------------------------------------------- | -------------------------------------------------------------------------------------- | | [Registration](../journeys/journeys.html#registration) | Information about the default registration journey. | | [Journeys](../journeys/journeys.html) | Conceptual information on journeys and their purpose in Advanced Identity Cloud. | | [Journey nodes](../journeys/auth-nodes.html) | Learn about the configurable nodes Advanced Identity Cloud offers for use in journeys. | | [Manage identities](../identities/manage-identities.html) | Manage, group, and assign privileges to identities. | ### Nodes used The User Registration journey uses the following nodes: * [Page node](https://docs.pingidentity.com/auth-node-ref/latest/page.html) * [Platform Username node](https://docs.pingidentity.com/auth-node-ref/latest/platform-username.html) * [Attribute Collector node](https://docs.pingidentity.com/auth-node-ref/latest/attribute-collector.html) * [Accept Terms and Conditions node](https://docs.pingidentity.com/auth-node-ref/latest/accept-terms-and-conditions.html) * [Email Suspend node](https://docs.pingidentity.com/auth-node-ref/latest/email-suspend.html) * [Platform Password node](https://docs.pingidentity.com/auth-node-ref/latest/platform-password.html) * [Create Object node](https://docs.pingidentity.com/auth-node-ref/latest/create-object.html) * [Increment Login Count node](https://docs.pingidentity.com/auth-node-ref/latest/increment-login-count.html)