PingOne

Models, attributes, and error codes

When using the Magic Link IdP Adapter through the PingFederate authentication API, the adapter uses the following state models, action models, objects, and error codes.

State models

Status Response Model Action Description

LINK_INITIATED

  • transactionID (string): The transaction ID that can be used to check the status of the magic link request.

  • email (string): The masked email address that the magic link was sent to. This value can be null if no email was found, or if the Show Email advanced setting isn’t configured in the adapter instance.

  • poll

The link has been generated and sent to the user. PingFederate is awaiting action from the user.

LINK_COMPLETED

No model

  • continue

The user has clicked the link and completed the process. This allows the application to present a screen to the user if desired.

LINK_EXPIRED

No model

  • continue

The transaction ID that’s associated with the link has expired. A new one must be generated.

Action Models

Action Request Model Errors Description

poll

No model

None

Checks the status of a magic link transaction to see if the user has clicked the link yet.

continue

No model

None

Continues the flow.