Configuring PingOne Verify - PingOne - PingOne Services - PingOne Verify - PingOne Cloud Platform

PingOne Cloud Platform
bundle
pingone
ft:publication_title
PingOne Cloud Platform
Product_Version_ce
PingOne
PingOne Cloud Platform
category
Administratorguide
ContentType
Guide
Product
Productdocumentation
p1
p1cloudplatform
ContentType_ce
Guide
Guide > Administrator Guide
Product documentation

Configure and integrate PingOne Verify into your user identity verification flow.

Regardless of the configuration method you choose, you’ll need:

There are four ways to configure PingOne Verify:

  • API integration
  • PingOne DaVinci
  • PingFederate Integration Kit
  • Mobile SDK

The configuration method that you choose depends on your role.

Role Configuration Method

Admins and developers

Typically use the PingOne REST API or PingOne DaVinci to get started quickly and test a verify transaction.

PingFederate admins

Use the PingFederate admin console to configure the PingOne Verify Integration Kit.

PingFederate supplies the authentication policy and user verification status for PingOne Verify.

Mobile developers

Use the PingOne Verify mobile SDK (iOS or Android) to create the app your users employ for ID verification.

Using the PingOne REST API

To configure PingOne Verify with the PingOne REST API:

  1. Create your theme in PingOne Branding and themes to brand the PingOne Verify web experience for your end users.
  2. Optional: If you enabled one-time passcode (OTP)one-time passcode (OTP)OTP A passcode valid for only one sign on or transaction on a computer system or other digital device. Also known as a one-time password, one-time PIN, or dynamic password. through phone or email verification in your policy, create notification templates.
  3. Trigger your first Verify transaction:
    1. Read Getting started with the PingOne APIs.
    2. Download the PingOne Postman collection.
    3. Note the variables you must value.
    4. Obtain a PingOne access token.

      Your {{authPath}} environment variable in Postman should begin with auth.pingone. See PingOne API domains to determine the correct {{authPath}} for your region. Note that nothing trails the domain in the {{authPath}} variable.

    5. Create a new Verify transaction with the Create Verify Transaction API call.

      Your {{apiPath}} environment variable in Postman should begin with api.pingone. See PingOne API domains to determine the correct {{apiPath}} for your region. Note that the trailing /v1 is required (for example, api.pingone.com/v1).

      For more information, see PingOne API requests.

      Postman renders a QR code.

      A screen capture of the QR code that Postman renders when creating a Verify transaction.
    6. Scan the QR code with a smartphone camera to try the mobile web flow.
  4. View the data submitted in the transaction and the scores returned from verification services.
    • Using the API: Use the verifiedData and metaData endpoints.
    • Using the PingOne admin console:
      1. In PingOne, go to Environment > Audit.
      2. Edit the Time Range and Within fields as needed.
      3. For Filter Type, select Event Type.
      4. For Filter, enter verify in the Search Filter Type field.
      5. Select any of the Verify event types.

        For more information, see Event types.

        A screen capture of the PingOne Audit page with "verify" entered in the Filter field.
      6. Click Run.
      7. To view the specific data and scores from an event, click View in the Details column in the report summary.

Using PingOne DaVinci

Add PingOne DaVinci to your PingOne environment. For more information, see Creating an environment.

To configure PingOne Verify using PingOne DaVinci:

  1. Create your theme in PingOne Branding and themes to brand the PingOne Verify web experience for your end users.
  2. Optional: If you enabled OTPone-time passcode (OTP)OTP A passcode valid for only one sign on or transaction on a computer system or other digital device. Also known as a one-time password, one-time PIN, or dynamic password. through phone or email verification in your policy, create notification templates.
  3. Import a flow template in PingOne DaVinci by downloading it from the Integration Directory: PingOne Verify quick start flow template.
  4. Update the flow with your PingOne Verify policy:
    1. Click the PingOne Verify Create transaction node in the flow.
    2. In the Verify Policy list, select the policy to use.
      A screen capture of the PingOne Verify Create transaction node details in PingOne PingOne.
  5. To run the flow and trigger a PingOne Verify transaction, click Try Flow.

    PingOne DaVinci renders a QR code.

    A screen capture of the QR code that you can scan with your mobile device to start the verification process.
  6. Scan the QR code on your mobile device to try the mobile web flow.
  7. View the data submitted in the transaction and the scores returned from verification services.
    • Using the API: Use the verifiedData and metaData endpoints.
    • Using the PingOne admin console:
      1. In PingOne, go to Environment > Audit.
      2. Edit the Time Range and Within fields as needed.
      3. For Filter Type, select Event Type.
      4. For Filter, enter verify in the Search Filter Type field.
      5. Select any of the Verify event types.

        For more information, see Event types.

        A screen capture of the PingOne Audit page with "verify" entered in the Filter field.
      6. Click Run.
      7. To view the specific data and scores from an event, click View in the Details column in the report summary.

Using PingFederate

To use PingFederate to configure the PingOne Verify Integration Kit:

Download PingFederate and the PingOne Verify Integration Kit from the PingFederate Downloads website.
Note:

You'll need to work with your Ping Identity account team to start a trial license for PingFederate.

For more information on getting started, see the PingOne Verify Integration Kit documentation.

Using the PingOne Verify mobile SDK

Mobile application developers use the PingOne Verify mobile SDK for iOS and PingOne Verify mobile SDK for Android to create the PingOne Verify app for their users. The app is a self-service app for iOS or Android devices that guides the user through the process of taking photos of their ID and a selfie and submitting the photos to PingOne for verification.

To use the PingOne Verify mobile SDK:

  1. Run the sample app from Github:
  2. Integrate the PingOne Verify mobile SDK into your own app: