--- title: "OneSpan Auth Visual Code (Node)" slug: "iaa-fig-onespan-auth-visual-code-node" updated: 2025-07-09T11:55:51Z published: 2025-07-09T11:55:51Z canonical: "docs.onespan.com/iaa-fig-onespan-auth-visual-code-node" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.onespan.com/llms.txt > Use this file to discover all available pages before exploring further. # OneSpan Auth Visual Code (Node) > Availability: OneSpan Authentication for ForgeRock 1.1.0 and later This node reads the visual code message from the sharedState object and renders it as a visual code. The end users can scan the image with a mobile app integrated with the Mobile Security Suite SDKs or authenticators with Cronto image support. The node can be part of a page node or be leveraged independently of the UI flow. Outcome paths: - Default ## Properties | OneSpan Auth Visual Code properties | | --- | | Property name | Data type | Description | | Message Options | Enum | Possible values: - DemoMobileApp. The node will look up the message stored by the predecessor node, usually [OneSpan Auth User Register (Node)](/sec/docs/iaa-fig-onespan-auth-user-register-node#properties). The message is formatted in a particular way that fits the demo mobile app. - CustomCrontoMessage. Use this value to implement your own message format and use your own authentication node to store the visual code message in the sharedState object. Default value: DemoMobileApp | | Custom Message In SharedState | String | Only required if Message Options is set to CustomCrontoMessage. Specifies the key name in the sharedState object to use as the customized visual code message. Default value: | | Visual Code Callback ID | String | Specifies a hidden value callback used by the node to return the image URL of the visual code. Default value: ostid_cronto | | Render Visual Code | boolean | If set to True, the node will return a JavaScript callback displaying the visual code and the countdown timer. If set to False, no JavaScript callback will be returned. You can use the image URL in the hidden value callback (Visual Code Callback ID) to render you own visual code page. Default value: True | | Visual Code DOM ID | String | Specifies the DOM ID of the element that contains the visual code. Default value: dialog | | Visual Code Type | Enum | Specifies the visual code type that your mobile app can detect and handle. Possible values: - Cronto - QR Default value: Cronto | | Visual Code Size | int | Specifies the size of the visual code. Default value: 210 | | Visual Code Alt Text | String | Specifies the alternative text to display if the image can’t be displayed properly. Default value: OneSpan TID Cronto Image | | Please Scan Text | String | The text to prompt the user to scan the visual code. The remaining countdown seconds will be automatically attached. Default value: Please Scan the Visual Code within: | | Please Scan CSS | String | The CSS definition to render the text label (Please Scan Text), e.g. "font-size: 14px; color: blue;" Default value: | | Expired Text | String | The text to show after the countdown to scan the activation data has reached 0. Default value: Your Activation Code has been expired! | | Expired CSS | String | The CSS definition to render the expired text (Expired Text), e.g. "font-size: 14px; color: red;" Default value: | ## Data flow

OneSpan Auth Visual Code inbound data

Attribute name

Source

Description

As specified in property

ostid_cronto_msg

Shared state

Visual code message

ostid_event_expiry_date

Shared state

The expiry date

ostid_cronto_has_rendered

Hidden value callback

A tag indicates whether the custom application has consumed the Cronto URL. In an API flow, you would set the hidden value callback input value to True, so that the node knows to proceed.

OneSpan Auth Visual Code outbound data

Attribute name

Storage

Description

As specified in property

Hidden value callback, shared state

Visual code image URL

ostid_event_expiry_date

Hidden value callback

The expiry date in Unix time, specific for API flow

ostid_cronto_has_rendered

Hidden value callback

A tag indicates whether the custom application has consumed the Cronto URL. In an API flow, you’d set the hidden value callback input value to True, so that the node knows to proceed.