Orchestration SDKs

Evaluating risk with PingOne Protect

PingOne Android iOS JavaScript

You can integrate PingOne Protect into your apps to evaluate the risk involved in a transaction.

A flowchart illustrating how risk predictors evaluate many different data points to determine whether to allow a user access or prompt mitigation.
Figure 1. A flowchart illustrating how risk predictors evaluate many different data points.

Your app can gather information during a transaction, return this information to PingOne Protect, and request a risk evaluation.

Based on the response from PingOne Protect, you can choose whether to allow or deny the transaction or perform additional mitigation, such as bot detection measures.

You can use the audit functionality in PingOne to view the risk evaluations:

Risk evaluation records in the PingOne audit viewer.
Figure 2. Risk evaluation records in the PingOne audit viewer.

Compatibility

PingOne

  • Your PingOne instance must have DaVinci enabled.

DaVinci flows

Ensure your flows only use supported connectors, capabilities and fields for user interactions:

  • HTTP Connector

    • Custom HTML capability

      View supported fields
      HTTP Connector field and collector support

      Field (Collector)

      Description

      DaVinci module

      Android

      iOS

      JavaScript

      Text field

      (TextCollector)

      Collects a single text string.

      ✅

      1.0.0

      ✅

      1.0.0

      ✅

      1.0.0

      Password field

      (PasswordCollector)

      Collects a single text string that cannot be read from the screen.

      ✅

      1.0.0

      ✅

      1.0.0

      ✅

      1.0.0

      Submit Button

      (SubmitCollector)

      Sends the collected data to PingOne to continue the DaVinci flow.

      ✅

      1.0.0

      ✅

      1.0.0

      ✅

      1.0.0

      Flow Button

      (FlowCollector)

      Triggers an alternative flow without sending the data collected so far to PingOne.

      ✅

      1.0.0

      ✅

      1.0.0

      ✅

      1.0.0

      Label

      (LabelCollector)

      Display a read-only text label.

      ✅

      1.1.0

      ✅

      1.1.0

      ✅

      1.1.0

      Radio / Dropdown

      (SingleSelectCollector)

      Collects a single value from a choice of multiple options.

      ✅

      1.1.0

      ✅

      1.1.0

      ✅

      1.1.0
      HTTP Connector SK-Component support

      SK-Component (Collector)

      Description

      DaVinci module

      Android

      iOS

      JavaScript

      skIDP

      (IdpCollector)

      Presents a button to allow users to authenticate using an external identity provider, such as Apple, Facebook, or Google.

      ✅

      1.1.0

      ✅

      1.1.0

      ✅

      1.1.0

      skrisk

      (ProtectCollector)

      Instructs the client to gather behavioral data and return it to PingOne so that it can perform risk evaluations.

      ✅

      1.3.0

      ✅

      1.3.0

      ✅

      1.3.0
      View unsupported features

      Verify that your flow does not depend on any unsupported elements:

      SKPolling components

      The SKPolling component cannot be processed by the DaVinci Client and should not be included in flows.

      Features such as Magic Link authentication require the SKPolling component and therefore cannot be used with the DaVinci Client.

      Images

      Images included in the flow cannot be passed to the SDK.

    For example, the PingOne sign-on with sessions DaVinci flow.

  • PingOne Form Connector

    • Show Form capability

      View supported fields
      Custom Fields support

      Field (Collector)

      Description

      DaVinci module

      Android

      iOS

      JavaScript

      Text Input

      (TextCollector)

      Collects a single text string.

      ✅

      1.1.0

      ✅

      1.1.0

      ✅

      1.1.0

      Password

      (PasswordCollector)

      Collects a single text string that cannot be read from the screen.

      ✅

      1.1.0

      ✅

      1.1.0

      ✅

      1.1.0

      Dropdown

      (SingleSelectCollector)

      Collects a value from a dropdown containing one or more text strings.

      ✅

      1.1.0

      ✅

      1.1.0

      ✅

      1.1.0

      Combobox

      (MultiSelectCollector)

      Collects a value from a dropdown containing one or more text strings, the user can enter their own text string.

      ✅

      1.1.0

      ✅

      1.1.0

      ✅

      1.1.0

      Radio Button List

      (SingleSelectCollector)

      Collects a value from one or radio buttons.

      ✅

      1.1.0

      ✅

      1.1.0

      ✅

      1.1.0

      Checkbox List

      (MultiSelectCollector)

      Collects the value of one or more checkboxes.

      ✅

      1.1.0

      ✅

      1.1.0

      ✅

      1.1.0

      Phone Number Input

      (PhoneNumberCollector)

      Collects a phone number, including the country code.

      ✅

      1.2.0

      ✅

      1.2.0

      ✅

      1.2.0
      Toolbox support

      Field (Collector)

      Description

      DaVinci module

      Android

      iOS

      JavaScript

      Flow Button

      (FlowCollector)

      Presents a customized button.

      ✅

      1.1.0

      ✅

      1.1.0

      ✅

      1.1.0

      Flow Link

      (FlowCollector)

      Presents a customized link.

      ✅

      1.1.0

      ✅

      1.1.0

      ✅

      1.1.0

      Translatable Rich Text

      (TextCollector)

      Presents rich text that you can translate into multiple languages.

      ✅

      1.1.0

      ✅

      1.1.0

      ✅

      1.1.0

      Social Login

      (IdpCollector)

      Presents a button to allow users to authenticate using an external identity provider, such as Apple, Facebook, or Google.

      ✅

      1.1.0

      ✅

      1.1.0

      ✅

      1.1.0

      MFA Device Selection - Authentication

      (DeviceAuthenticationCollector)

      Presents a list of methods for performing multi-factor authentication (MFA).

      DaVinci client currently only supports the Email, SMS, and Voice MFA types.

      ✅

      1.2.0

      ✅

      1.2.0

      ✅

      1.2.0

      MFA Device Selection - Registration

      (DeviceRegistrationCollector)

      Presents a list of methods you can register for multi-factor authentication (MFA).

      DaVinci client currently only supports the Email, SMS, and Voice MFA types.

      ✅

      1.2.0

      ✅

      1.2.0

      ✅

      1.2.0

  • PingOne Protect Connector

    • Create Risk Evaluation capability

      Android

      iOS

      JavaScript

      ✅

      1.3.0

      ✅

      1.3.0

      ✅

      1.3.0

Configuring PingOne for PingOne Protect

You must set up your PingOne instance to perform risk evaluations.

Integrate client apps with PingOne Protect DaVinci flows

Select your platform to discover how to configure your client application to perform PingOne Protect risk evaluations when you are using DaVinci flows:

Android

Integrate Android apps with PingOne Protect DaVinci flows
iOS

Integrate iOS apps with PingOne Protect DaVinci flows
JavaScript

Integrate JavaScript apps with PingOne Protect DaVinci flows