Manage Journeys

Identity Cloud comes with pre-configured end-user journeys (formerly called trees). A journey is an end-to-end workflow invoked by an end user or device. Common journeys are account registration and sign-in, for example. Identity Cloud provides templates for common end-user journeys.

You can use the drag-and-drop journey editor to configure or modify any of the ready-to-use journey templates.

Use only JavaScript for scripting. Identity Cloud does not support any other scripting languages.

Authentication template

Use the Login authentication template to configure sign-in journeys.

User self-service templates

Use a self-service template to let end users manage their accounts or resolve simple password issues without having to engage a system administrator.

Custom journey

Start with a blank canvas when you want to build a custom journey. Drag and drop nodes from the Journeys palette.

Default end-user journey

This is the journey Identity Cloud displays to your end users when they access your default webpage URL. For example, application webpages commonly display a Sign-In link. When the user clicks the link, the Login journey is invoked by default.

There are two ways to set a default end-user journey:

  • To set a new end-user journey as the default:
    In the New Journey dialog box, or in the Duplicate Journey dialog box, enable the option: Default journey for end users.

  • To set an existing end-user journey as the default:
    In the Admin UI, click Journeys to view the Journeys list.
    Find the existing journey you want to set as the default. Then from its More (⋯) menu, choose Set as default.

Device profiling support

Use the ForgeRock SDKs to create authentication journeys based on device context. See Configure Device Profiling Authentication.

Authentication templates

Login

Create a basic Login journey to let end users authenticate and sign into your app or service using username and password.

Show me the default login journey:
login
  1. In the Admin UI, go to Journeys > Login.

  2. Click Edit.

  3. Enter details for each node in the Login journey:

  4. To test the journey, copy the Preview URL, and paste the URL into a browser using Incognito or Browsing mode.

  5. When you’re satisfied with your journey, click Save.

Device profiling

Use the ForgeRock SDK to create journeys that let inanimate objects authenticate based on device context. Cell phones and smartwatches are examples of devices that have own identities. Device context provides Identity Cloud with information about how or where a device is used to authenticate.

For detailed instructions, see Configure Device Profiling Authentication.

User self-service templates

Registration

Create a registration journey to let end users create their own account for your app or service.

Show me the default registration journey:
register
  1. In the Admin UI, go to Journeys > Registration.

  2. Click Edit.

  3. Enter details for each node in the Registration journey.

  4. To test the journey, copy the Preview URL, and paste the URL into a browser using Incognito or Browsing mode.

  5. When you’re satisfied with your journey, click Save.

Progressive profile

Create a Progressive Profile journey to when you want to trigger a conditional event in the end user’s journey.

The default journey triggers a reminder for the end user to set their preferences for receiving news and special offers. The reminder is displayed only if the end user logs in three times without selecting preferences. If the end user makes no selection, the reminder expires and is not displayed again. If the end user selects one or more options, the preferences get set in the end-user’s profile.

Show me the default progressive profile journey:
progressive login
  1. In the Admin UI, go to Journeys > Progressive Profile.

  2. Click Edit.

  3. Provide details for these nodes in the Progressive Profile journey:

  4. In the Admin UI, go to Journeys > Progressive Profile.

  5. Provide details for these nodes in the Progressive Profile journey:

  6. To test the journey, copy the Preview URL, and paste the URL into a browser using Incognito or Browsing mode.

  7. When you’re satisfied with your journey, click Save.

Update password

Create an Update Password journey to let end users change their existing passwords. End users may be required to change their password at regular intervals. Or they might have to change a password that’s been compromised.

  1. In the Admin UI, go to Journeys > Update Password.

  2. Click Edit.

  3. Provide details for these nodes in the Update Password journey:

  4. To test the journey, copy the Preview URL, and paste the URL into a browser using Incognito or Browsing mode.

  5. When you’re satisfied with your journey, click Save.

Reset password

Create a Reset Password journey to let end users change their existing passwords. End users typically reset their passwords when they’ve forgotten the password they set.

Show me the default reset password journey:
reset password
  1. In the Admin UI, go to Journeys > Reset Password.

  2. Click Edit.

  3. Provide details for these nodes in the Reset Password journey:

  4. To test the journey, copy the Preview URL, and paste the URL into a browser using Incognito or Browsing mode.

  5. When you’re satisfied with your journey, click Save.

Forgotten username

Create a Forgotten Username journey to let end users retrieve their username from their user account data.

Show me the default forgotten username journey:
forgot username
  1. In the Admin UI, go to Journeys > Forgotten Username.

  2. Click Edit.

  3. Provide details for these nodes in the Forgotten Username journey:

  4. To test the journey, copy the Preview URL, and paste the URL into a browser using Incognito or Browsing mode.

  5. When you’re satisfied with your journey, click Save.

Custom journeys

Create a custom journey when none of the ready-to-use templates suits your needs.

  1. In the Admin UI, click Journeys.

  2. Click + New Journey.

  3. Enter journey details.

    Journey Details:
    • Name: Name to display in the Journeys list.

    • Identity Object: Identifier for the user or device to authenticate

    • (Optional) Description: Summarize end-user interaction.

    • (Optional) Tags: For organizing journeys to make them easier to find.

  4. Click Create journey.

  5. Use the journey editor to create your custom journey.
    Drag nodes from the palette and arrange them on the blank canvas.

  6. Provide information for each node.
    For information about all available nodes, see Authentication Nodes Configuration Reference.  

  7. To test the journey, copy the Preview URL, and paste the URL into a browser using Incognito or Browsing mode.

  8. When you’re satisfied with your journey, click Save.

Duplicate journeys

Make a duplicate journey when you want to preserve a template for future use. For example, if you are testing a journey, start with a duplicate. Be sure to give the duplicate journey a unique name.

You can create a duplicate journey in two ways:

  • Click Journeys to view the existing journeys list.
    Find the template name. Then click its More (⋯) menu, and choose Duplicate.

  • If you’re using the Journey editor, click More (⋯), and choose Duplicate.

More information

For deep dives into how the journey editor works, see: