Skip to content

Auth0 Password Authentication

Client SDK
Backend API
Mobile approve
SSO
Sub-journey

Authenticates the user with Auth0 using username and password

Description

This step authenticates the user by validating their credentials against Auth0–an external identity provider. It is used for Just-In-Time (JIT) migration scenarios where users are gradually migrated from Auth0 to Mosaic as they log in.

Before using this step, configure an Auth0 connection in Integration Hub.

The user's credentials must be obtained before initiating this step, such as using a Collect information form. If the authentication succeeds, the journey continues to the next step. The authentication result, including user information from Auth0, is stored in the output variable and can be used in subsequent steps (e.g., to create a user in Mosaic).

If the authentication fails (e.g., incorrect password), the journey proceeds to the failure branch (if specified); otherwise, the journey is aborted and an error is sent to the client.

Configuration

FieldDescription
Auth0 integrationThe Auth0 connector to use for authentication, as configured in Integration Hub.
UsernameExpression that yields the user's username.
PasswordExpression that yields the user's password.
ScopeOAuth scopes to request from Auth0. Default: openid profile email.
Output variableName of the variable that stores the authentication result returned by Auth0.
Error output variableName of the variable that stores any errors returned by the step.
Failure behaviorDetermines the behavior in case of failure, which either aborts the journey or proceeds to a failure branch of the control flow (default).
Journey event data

This step can be configured to record step input and output data, or a custom payload, which is then surfaced in journey events in Journey Analytics for diagnostic purposes. For details, see Additional data reporting.

Example

Consider a migration journey that collects username and password using a Collect information step. In this example, the form collects username and password, and the input is stored in loginData.

The Auth0 Password Authentication step validates these credentials against Auth0. If successful, the output variable (auth0_output) contains user information, including ID token and user_info, that can be used to create or update a user in Mosaic using the Create user step.