Choice Collector node
The Choice Collector node defines two or more options to present to the user during authentication.
Example
The following example demonstrates using the Choice Collector node in a multi-factor authentication (MFA) journey to provide the user with a choice to receive the one-time password (OTP) via email or SMS:
-
The Page node containing the Platform Username node and Platform Password node prompts for credentials.
-
The Data Store Decision node validates the username-password credentials.
-
The HOTP Generator node generates an eight-digit OTP.
-
The Choice Collector node prompts the user to choose whether they want to receive the OTP via email or SMS.
-
If the user chooses email, the OTP Email Sender node sends the OTP to the user’s email address.
-
If the user chooses SMS, the OTP SMS Sender node sends the OTP to the user’s mobile number.
-
-
The OTP Collector Decision node prompts the user to enter the OTP they received and verifies it. If the OTP is correct, the user is authenticated.
Availability
| Product | Available? |
|---|---|
PingOne Advanced Identity Cloud |
Yes |
PingAM (self-managed) |
Yes |
Ping Identity Platform (self-managed) |
Yes |
Inputs
The node can read the authLevel and targetAuthLevel from the incoming node state if they exist.
When present, the node uses them to filter the choices available to the user to ensure only choices that can meet or exceed the targetAuthLevel are shown.
Configuration
| Property | Usage | ||
|---|---|---|---|
Choices |
Enter two or more choice strings to display to the user. To remove a choice, select its Delete icon (). |
||
Default Choice |
Enter the value of the choice to be selected by default.
|
||
Prompt |
Enter the text to display to the user when presenting the choices. |
||
Field Display Type |
The format of the options presented to the user.
Possible values are:
|
Callbacks
The node sends a ChoiceCallback, which displays the list of Choices to the user and contains the Prompt.