Note:

The following example builds and configures a widget-based DaVinci flow for integration with PingFederate. To show that the integration works, it displays the passed PingFederate values in a user-facing page. Flows can have different user-facing elements or none at all, depending on whether you build a widget-based flow or an API-based flow.

A screen capture of the example DaVinci flow.
  1. In the DaVinci admin portal, go to Flows, and open the blank flow that you created in Adding an application in DaVinci.
  2. Add PingFederate to your flow's input schema.
    1. Go to Flow Options (⋮) > Input Schema.
    2. Click Add.
    3. In the Parameter Name field, enter the exact name that you defined in the DaVinci Parameter Name column in your DaVinci adapter configuration.
      Important:

      You must add nonce as a parameter with the Data Type set to String.

      Screen capture of the nonce parameter with the Data Type set to String and the Required setting enabled.
    4. Repeat steps b-c for each parameter that you defined in the Simple Parameter Mappings and Advanced Parameter Mappings tables.
    5. Click Save.
  3. Optional: If you're building a widget-based flow, create a registration form.
    Note:

    This example node represents the functional part of the flow. When you build your own flow, this step is where you customize the flow.

    1. On the flow canvas, add the HTTP connector and select the HTML Form capability. Select the node that appears in your flow.
    2. In the Title field, enter a title, such as Registration.
    3. In the Fields List section, add fields for the following:
      • Username
      • Password
      Tip:

      For help, see the HTTP connector.

    4. In the Next Button Text field, enter Sign Up.
    5. Click Apply.
  4. Optional: For widget-based flows, show the parameters DaVinci received from PingFederate.
    Note:

    This node is for demonstration purposes only. You don't need it when you build your own flow.

    1. Following your HTML Form node in your flow, add the HTTP connector and select the Custom HTML Message capability. Select the node that appears in your flow.
    2. In the Title field, enter a title, such as Welcome.
    3. In the Message field, enter the following:
      Confirm your information:
      
      Chained Attributes
      
      Specified chained val: 
      
      Extended Properties
      
      Specified extended array: 
      
      PAR Object
      
      Specified PAR: 
      
      Server Base URL: 
      
      
    4. Populate the message by clicking {} and inserting variables from your flow's input schema.