---
title: OneSpan Identity Verification node
description: The OneSpan Identity Verification node performs document verification using OneSpan. The user is redirected to OneSpan to verify their identity and returned to the authentication journey.
component: auth-node-ref
version: latest
page_id: auth-node-ref:cloud:onespan-id-verify
canonical_url: https://docs.pingidentity.com/auth-node-ref/latest/cloud/onespan-id-verify.html
keywords: ["OneSpan", "Authenticator", "Identity Verification"]
page_aliases: ["auth-node-onespan-id-verify.adoc"]
section_ids:
  example: Example
  availability: Availability
  inputs: Inputs
  dependencies: Dependencies
  configuration: Configuration
  outputs: Outputs
  outcomes: Outcomes
  troubleshooting: Troubleshooting
---

# OneSpan Identity Verification node

The OneSpan Identity Verification node performs document verification using OneSpan. The user is redirected to OneSpan to verify their identity and returned to the authentication journey.

## Example

This example journey highlights the use of the OneSpan Identity Verification node:

![onespan id verify journey](_images/onespan-id-verify-journey.png)

## Availability

| Product                               | Available? |
| ------------------------------------- | ---------- |
| PingOne Advanced Identity Cloud       | Yes        |
| PingAM (self-managed)                 | Yes        |
| Ping Identity Platform (self-managed) | Yes        |

## Inputs

This node requires the following inbound data:

| Description  | Attribute name                   | Source       |
| ------------ | -------------------------------- | ------------ |
| First Name   | objectAttributes.givenName       | Shared state |
| Last Name    | objectAttributes.sn              | Shared state |
| Phone Number | objectAttributes.telephoneNumber | Shared state |

## Dependencies

To use this node, you must integrate OneSpan in your PingOne Advanced Identity Cloud tenant environment and enable OneSpan identity verification.

## Configuration

| Property                | Usage                                                                                |
| ----------------------- | ------------------------------------------------------------------------------------ |
| OneSpan Auth Token      | The authentication token used in OneSpan identity verification.                      |
| OneSpan tenant ID       | The OneSpan identity verification tenant ID.                                         |
| OneSpan IDV URL         | The OneSpan URL to which this node will redirect to get identity verification.       |
| OneSpan IDV workflow ID | The workflow ID for the OneSpan identity verification tenant.                        |
| BrandID                 | The brand ID for the OneSpan identity verification tenant.                           |
| Language                | The default language for the OneSpan identity verification tenant.                   |
| failUrl                 | The URL to be returned to after OneSpan identity verification fails.                 |
| passUrl                 | The URL to be returned to after OneSpan successfully verifies the identity.          |
| defaultUrl              | The default URL to be returned to after OneSpan identity verification.               |
| errorUrl                | The URL to be returned to if errors occur during OneSpan identity verification.      |
| sessionTimeoutUrl       | The URL to be returned to after the OneSpan identity verification session times out. |
| role                    | The role to be sent for OneSpan identity verification.                               |

## Outputs

| Output variable         | Description                               |
| ----------------------- | ----------------------------------------- |
| **OneSpan IDV Results** | Results of OneSpan identity verification. |

## Outcomes

* `Pass`

  Identity is successfully verified.

* `Fail`

  Identity verification failed.

* `Error`

  An error occurred while verifying identity. An error message is output to the shared state.

## Troubleshooting

If this node logs an error, review the log messages for the transaction to find the reason for the exception and address the issue appropriately.