PingOne

State models, action models, and attributes

When using the PingOne Verify IdP Adapter through the PingFederate authentication application programming interface (API), the adapter uses the following state models, action models, and attributes.

Table 1. State models
Status State Model Action Description

ID_VERIFICATION_REQUIRED

  • verifyAppName

  • qrUrl

  • verificationCode

  • errorDetails

  • poll

  • cancelAuthentication

Indicates that verification is required. This state is the first state returned from the adapter.

ID_VERIFICATION_IN_PROGRESS

  • poll

Indicates that ID verification is in progress.

ID_VERIFICATION_COMPLETED

  • continueAuthentication

Indicates that ID verification completed successfully.

ID_VERIFICATION_FAILED

  • errorDetails

  • cancelAuthentication

Indicates that ID verification failed and a retry is not allowed.

ID_VERIFICATION_TIMED_OUT

  • retryVerification

  • cancelAuthentication

Indicates that ID verification timed out.
Action models
Action Action Model Error Description

poll

(void)

Gets the current ID transaction status.

retryVerification

(void)

Retries verification after a time out.

Retry must be enabled in the adapter instance configuration.
Attribute models
Attribute name Type Description

verifyAppName

String

The name of the verification app.

This name is provided from the Verify App Name field in the adapter instance configuration.

You can use this name to help customers find the right verification app in the Google Play Store or Apple App Store.

qrUrl

String

The URL of the QR code image associated with the verification session.

Use this URL to show the QR code to the user. The user scans the QR code with the verification app to begin the verification process.

To display the QR code, your app needs to perform a GET request to the URL provided in qrUrl. Include an <img> element, and use the result of the GET request as the source.

For example:

QR URL provided by PingFederate:

"qrUrl":"https://api.pingone.com/v1/idValidations/shortcode/008030285946/qr"

GET request to get the QR code image:

GET "https://api.pingone.com/v1/idValidations/shortcode/008030285946/qr"

GET request response:

data:image/jpeg;base64,9j4AAQSkZJRgABAgAAAQABAAD
IsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL...2wBDAQkJCQwL
DBgNDRgyIRwhMjIyMjIyMj

HTML element that displays the image in your app:

<img src="data:image/jpegbase64,9j4AAQSkZJRgABAgAAAQABAAD
IsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL...2wBDAQkJCQwL
DBgNDRgyIRwhMjIyMjIyMj"/>

verificationCode

String

A code that the user can enter instead of scanning the QR code image.

errorDetails

List<CustomAuthnErrorDetail>

A list of errors.