PingOne

Configuring a sign-on form

You can use forms created in User Experience > Forms to allow users to sign on with credentials, social login providers, or a magic link.

Creating a sign-on form with username and password

To configure a simple sign-on form to allow users to authenticate with their credentials:

Steps

  1. In the PingOne admin console, go to User Experience > Forms.

  2. Click the[.uicontrol] icon and select the Sign On template.

  3. (Optional) Customize the templated form using the form builder. Learn more in Form properties, Form fields, and Form toolbox.

    The Sign On form template.

  4. Click Save.

Result

You can now use the form in your DaVinci flow with the PingOne Forms connector.

Creating a sign-on form with social login

Before you begin

In the PingOne admin console, go to Integrations > External IdPs and configure social login providers. Learn more in Adding a vendor-specific identity provider in PingOne.

If you don’t have social login providers configured in your PingOne environment, the Social Login component won’t be available in the form builder.

Steps

To configure a sign-on form with social login:

  1. In the PingOne admin console, go to User Experience > Forms, click and select the Sign On template.

  2. Add a Divider component and optionally add a centered label, such as OR, to the divider.

  3. Add one or more Social Login components below the divider to allow the end user to authenticate with social login.

  4. (Optional) You can further customize the templated form in the form builder. Learn more in Form properties, Form fields, and Form toolbox.

Result

You can now use the form in your DaVinci flow with the PingOne Forms connector.

A Magic Link Authentication form providing a key for the PingOne Forms connector and the value of the PingOne forms connector outputting an OTP challenge to the user-facing screen.

To configure a sign-on form with magic link:

Steps

  1. Create an email prompt form:

    1. In the PingOne admin console, go to User Experience > Forms.

    2. Click and select Blank Form.

    3. In the Form Name field, enter a title for the form, such as Sign On.

    4. (Optional) Enter a Form Description.

    5. In Fields > PingOne Attribute Fields > Contact, drag an Email field onto the form.

    6. In the Form Toolbox, drag a Submit Button component onto the form.

  2. Create a magic link prompt form:

    1. In the PingOne admin console, go to User Experience > Forms.

    2. Create a form with the Magic Link Prompt template.

    3. (Optional) Customize the templated form using the form builder. Learn more in Form properties, Form fields, and Form toolbox.

  3. Configure the DaVinci flow:

    1. Add a Challenge connector node in your flow and create an out-of-band challenge flow pattern. Learn more about creating challenges in Challenge connector.

    2. Add a PingOne Forms connector node and select the Show Form capability.

    3. Toggle Enable Polling on and set it up to poll the challenge created earlier in the flow by the Challenge connector.

    4. In the Dynamic Text table, map the user’s email address or phone number with the magicLinkHint Key.