DigipassONE Verify is part of v10.0 and v10.1 - a limited, early access release for users who wish to evaluate supporting digital credentials in their applications.
It is not intended for production use.

This document is currently being updated. A new version with updated information will be published presently.

Implement digital credentials with the Web Tutorial App

Prev Next

Requirements

Component

Requirement

IDE

Eclipse IDE for Enterprise Java and Web Developers

Device

  • iPhone 13 or later with iOS 18.7 or later

  • Android device with Android 15 or later

Data wallet

OneSpan Wallet

Other

  • Java 17 or later configured in Eclipse’s Preferences → Java → Installed JREs configuration page

  • Apache tomcat 10.1 or later

The Web Tutorial App is included with the DigipassONE App SDK for Web. It is a simple client application that will teach you how to implement digital credentials by:

  • Building and deploying a client application.

  • Connecting and testing a client application.

Below are detailed, step-by-step guides to help you get started.

Install OneSpan Wallet

iOS users

Refer to Implement digital credentials with the iOS Tutorial App for instructions on how to install the wallet in your iOS device.

Android users

Refer to Implement digital credentials with the Android Tutorial App for instructions on how to install the wallet in your Android device.

Download the Web SDK

  1. Login to the DigipassONE portal.

  2. Locate the Software Downloads tile and click on Web SDK.

  3. Download the zip file.

Build the Web Tutorial app

  1. Extract the digipassone_appsdk_web-<version>.zip file.

  2. Open Eclipse, import project from path_to_digipassone_appsdk_web-<version>/src/gwtutorial folder.

  3. Edit the JWTExternalAuthServlet.java file and replace the values of TENANT, KEY and ISSUER constants with the corresponding values from the jwt_config configuration of JWT Authentication Method plugin configured for your tenant.

  4. Edit the /etc/hosts file and map nneval-tutorial.noknokeval.com to 127.0.0.1.

  5. Copy the path_to_digipassone_appsdk_web-<version>/certs folder to a place that Tomcat can access.

  6. Edit the Tomcat’s server.xml configuration file and add or modify the <Connector> element for the HTTPS configuration:

    <Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol" maxThreads="150" SSLEnabled="true">
        <SSLHostConfig certificateVerification="none">
            <Certificate certificateKeystoreFile="<path_to_certs>/certs/tls.noknokeval.pkcs12"
                certificateKeystorePassword=""
                certificateKeystoreType="PKCS12"
                sslProtocol="TLS"
                type="RSA" 
            />
        </SSLHostConfig>
    </Connector>
  7. If you are using a Tomcat server configured in the Eclipse, add the gwtutorial project to it and start it. Otherwise export gwtutorial project as war file and deploy it in Tomcat’s webapps folder and restart Tomcat.

Configure the Web Tutorial app for your tenant

  1. Navigate to https://nneval-tutorial.noknokeval.com/gwtutorial/configure page.

  2. Change the Deployment dropdown to cloud.

  3. Enter https://preview.digipassone.com in the Server Host input.

  4. Enter your tenant ID in the Tenant input.

  5. Click Apply Configuration.

Test the Web Tutorial app

Register a digital credential

On your desktop

  1. Launch the Web Tutorial app by opening a browser and navigating to https://nneval-tutorial.noknokeval.com/gwtutorial/.

  2. You may enter any username before clicking Next.

  3. Make sure to enter noknok in the Password field, then click Next.

  4. You will be prompted to set up authentication. Select Digital Credential.

  5. You will see a dialog asking, Are you ready to invoke your Identity Wallet? Click Next to confirm.

  6. A QR code will be displayed.

On your mobile device

  1. Using your mobile device, scan the QR code on your desktop by:

    • Launching OneSpan Wallet and clicking Scan QR Code

    • Using your device’s camera app.

  2. You should see a new credential in the Receive section. Click Receive.

    • If this is the first time you created a digital credential, there should be No credentials listed at the bottom of the screen.

  3. The Add credential screen will appear. Review the details before clicking Confirm.

  4. The new credential will be listed at the bottom of the screen.

On your desktop

  1. Once the credential has been received, the Web Tutorial app will display the Register page with the new credential:

Login with a digital credential

On your desktop

  1. Make sure to log out from the Web Tutorial app.

  2. Log back in with the username you used to register - the field may be pre-filled. Click Next.

  3. You will see an option to Sign in with Digital Credential. Click on it.

  4. You will see a dialog asking, Are you ready to invoke your Identity Wallet? Click Next to confirm.

  5. A dialog with QR code will be displayed.

On your mobile device

  1. Using your mobile device, scan the QR code on your desktop by:

    • Launching OneSpan Wallet and clicking Scan QR Code

    • Using your device’s camera app.

  2. You will see the request to present a credential in the Present section. Click Present.

  3. You will be asked to Share Credentials? Review the information provided before clicking Confirm.

    • If you have more than one credential, select the one that you wish to use.

On your desktop

  1. Once the credential has been received, the Web Tutorial app will display the Register page on your desktop browser where you can complete the authentication process.

Authenticate a transaction with a digital credential

  1. Navigate to the Transaction page in the Web Tutorial app.

  2. On the Transaction page enter a transaction amount and click Next.

  3. Click Authorize on the confirmation dialog:

  4. A confirmation dialog will be displayed, click Next.

  5. A dialog with QR code will be displayed. Open the OneSpan wallet on your mobile device, click Scan QR Code and scan the QR code (or scan it with your device’s camera app).

  6. You will see the request to present a credential in the Present section. Click Present.

  7. Verify the transaction details and click Confirm on the “Share credentials?” confirmation screen. 

  8. The transaction will be completed and the Web Tutorial app will display the confirmation

Remove a digital credential from the Web Tutorial app

  1. Navigate to the Register page in the Web Tutorial app.

  2. Click the trash can button in the digital credential tile:

  3. Click Yes on the confirmation dialog:

  4. The credential will be deleted.

Removing a digital credential from the Web Tutorial app will not remove it from the OneSpan Wallet.

Opening the Web Tutorial app in a mobile browser

If you wish to run the Web Tutorial app on a local computer — e.g., with a Tomcat server in Eclipse — and access it with a mobile browser, you will need to:

  • run a proxy server on your computer

  • configure Wi-Fi settings on the mobile device to use the proxy server

  • ensure that both devices are on the same network.

When using a mobile browser, if you click Next on the Invoke Wallet dialog, you will be asked to allow access to the information in your digital wallet instead of being presented with a QR code.

iOS confirmation screen

Android confirmation screen