--- title: "Implement digital credentials with the Web Tutorial App" slug: "dpo-verify-implement-digital-credentials-with-the-web-tutorial-app" tags: ["S3 v10.1", "S3 v10.0"] updated: 2026-11-14T22:49:30Z published: 2026-11-14T22:49:30Z canonical: "docs.onespan.com/dpo-verify-implement-digital-credentials-with-the-web-tutorial-app" --- > ## 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. # Implement digital credentials with the Web Tutorial App ## 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](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-ios-tutorial-app#install-onespan-wallet) for instructions on how to install the wallet in your iOS device. ### Android users Refer to [Implement digital credentials with the Android Tutorial App](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-android-tutorial-app#install-onespan-wallet) for instructions on how to install the wallet in your Android device. ## Download the Web SDK 1. Login to the [DigipassONE portal](https://preview.digipassone.com/noknok/webapps/nnllauncher/dashboard.jsp). 2. Locate the **Software Downloads** tile and click on **Web SDK**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dpoverify-software-downloads.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=OqmJaYJSEA28U65UH%2FwEaVkmBcHWo2ksIHMfjIiToUc%3D) 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: ```xml                 ``` 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](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/](https://nneval-tutorial.noknokeval.com/gwtutorial/). 2. You may enter any username before clicking **Next**. 3. Make sure to enter `noknok` in the P*assword* field, then click **Next**. 4. You will be prompted to set up authentication. Select **Digital Credential**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-web-app-setup-passkey_updated.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=8zoke6Gz17zqSfvrpSDjTThQSaUt2BAPsZk%2BNtBKkTI%3D) 5. You will see a dialog asking, *Are you ready to invoke your Identity Wallet?* Click **Next** to confirm. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/image(99).png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=oFJBY4anaqAoop31qI5tq6NXeJBtj41z1Ucw%2FME4D%2Fg%3D) 6. A QR code will be displayed. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/image(100).png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=yfSKEei1h6mthvEwwnDRP437PvKB8QMAjubAwrH1BG4%3D) **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**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-oswallet-receive-cred-1st(3).png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=PJ3WIa882R3vn6j5rwXxTwWnmms0pOs3ogoIisSjhvE%3D) - 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**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-oswallet-ad-cred-1st(2).png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=Tjl8jRELiJEXHpDl64hUsLHpy9qXwxHelWn5l0nWcZI%3D) 4. The new credential will be listed at the bottom of the screen. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-app-new-cred-wallet_blurred.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=oSc3iP%2BVS%2F0MqbRKVui4CfL614ertK2bCtfnqijP%2BOg%3D) **On your desktop** 1. Once the credential has been received, the Web Tutorial app will display the *Register page* with the new credential: ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-web-app-register-cred.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=ChxsB6ZzSEbsz6F4boQj%2B%2BrzRKBJZ7ewzRV9DzzZ6sM%3D) ### 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. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/image(106).png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=vHyiUccLwwOFxbElsk%2BT6uMVk2Gkpfl66pZzBl7Okm8%3D) 4. You will see a dialog asking, *Are you ready to invoke your Identity Wallet?* Click **Next** to confirm. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/image-FWZQHFMT.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=nqPXOD%2BjkDLAJlkTw5uvk3lAtYxX3%2BgYuC3FAZvv5YA%3D) 5. A dialog with QR code will be displayed. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/image-TRLDF0BG.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=prfMbFZcFHAkIqF5UbVFpadZ7KU%2BNwDX5Vrh95CCHlg%3D) **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**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-oswallet-present-cred_blurred.jpg?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=k6McxxekHy%2BopGwqG3NRC2AuSjjEdgDXXIvSl8TCOE0%3D) 3. You will be asked to *Share Credentials?* Review the information provided before clicking **Confirm**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-android-signin-share-cred_blurred.jpg?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=7H32oWIJOQWk5rHW1E1kuXvLyMv7oz%2F9p7jl4xp%2BFY4%3D) - 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: ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/image-CZB0FBPG.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=ub%2B8ojDpr1fYQyBs7%2BwDYQ43V4EPjrTcv6IXehP9JIw%3D) 4. A confirmation dialog will be displayed, click **Next**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/image-FWZQHFMT.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=nqPXOD%2BjkDLAJlkTw5uvk3lAtYxX3%2BgYuC3FAZvv5YA%3D) 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). ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/image-TRLDF0BG.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=prfMbFZcFHAkIqF5UbVFpadZ7KU%2BNwDX5Vrh95CCHlg%3D) 6. You will see the request to present a credential in the Present section. Click **Present**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-web-app-wallet-ready-mobile.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=451Ha3zWGevlNeaRI9ZWsuhDvVvi9eYqctEH92ThXdY%3D) 7. Verify the transaction details and click **Confirm** on the “Share credentials?” confirmation screen. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-web-app-share-cred-mobile(1).png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=bSaPTdXhBpYvhGb5bIL6flc9u4OrwZg0TgXbCWjy1X4%3D) 8. The transaction will be completed and the Web Tutorial app will display the confirmation ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/image-1TBS9N9T.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=5rWunlOhFQe2pN%2B%2BPYva306Z9wn8VlUUDES4SDS33n4%3D) ### 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: ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-web-app-remove-cred.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=Fa29YGXmz7sflPAvSst5lBfhZQU3EuaHlX1nFUE1eGs%3D) 3. Click **Yes** on the confirmation dialog: ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-dc-web-app-remove-cred-confirmation.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=MPJnhjKkx2kEcToIQj14gWC7azldyd07%2FeIdVGVw%2FDY%3D) 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** ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/image-C8O7NDXU.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=oXwPFBOvBef9T9OLypf5i5TMX75VGadmSacT%2B%2FLup4U%3D) **Android confirmation screen** ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/image-CJFQ0YM2.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A15%3A59Z&se=2026-11-18T20%3A15%3A59Z&sr=b&sp=r&sig=mmIklKhoJ0oU3XS6ukrhCkx2jbnVMJo7NAZSXtQ0b9w%3D) Formerly known as Digipass S3 App SDK. Includes SDKs for Android, iOS and web.