--- title: "Implement digital credentials with the iOS Tutorial App" slug: "dpo-verify-implement-digital-credentials-with-the-ios-tutorial-app" tags: ["S3 v10.1", "S3 v10.0"] updated: 2026-11-14T22:48:26Z published: 2026-11-14T22:48:26Z canonical: "docs.onespan.com/dpo-verify-implement-digital-credentials-with-the-ios-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 iOS Tutorial App ## Requirements | Component | Requirement | | --- | --- | | **IDE** | [Xcode 11.0 or later](https://developer.apple.com/xcode/) | | **Computer** | Mac OS X 10.12.6 or later | | **Device** | iPhone 13 or later with iOS 18.7 or later | | **Data wallet** | OneSpan Wallet | | **Other** | - Apple Developer account - Unique bundle ID1 - TestFlight app | > 1 You must provision a unique bundle ID for your version of the iOS Tutorial app. To learn more, see the [Apple documentation on App ID Identifiers](https://developer.apple.com/documentation/appstoreconnectapi/bundle-ids). The **iOS Tutorial App** is included with the DigipassONE App SDK for iOS. 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](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-ios-tutorial-app#install-onespan-wallet) - [Download the iOS SDK](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-ios-tutorial-app#download-the-ios-sdk) - [Build the iOS tutorial app](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-ios-tutorial-app#build-the-ios-tutorial-app) - [Enable Touch ID authentication](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-ios-tutorial-app#enable-touch-id-authentication) - [Connect the iOS tutorial app to your tenant](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-ios-tutorial-app#connect-the-ios-tutorial-app-to-your-tenant) - [Get the configuration settings](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-ios-tutorial-app#get-the-configuration-settings) - [Configure the iOS tutorial app](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-ios-tutorial-app#configure-the-ios-tutorial-app) - [Test the iOS tutorial app](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-ios-tutorial-app#test-the-ios-tutorial-app) - [Register a digital credential](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-ios-tutorial-app#register-a-digital-credential) - [Login with a digital credential](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-ios-tutorial-app#login-with-a-digital-credential) - [Authenticate a transaction with a digital credential](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-ios-tutorial-app#authenticate-a-transaction-with-a-digital-credential) - [Remove a digital credential from the iOS tutorial app](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-ios-tutorial-app#remove-a-digital-credential-from-the-ios-tutorial-app) ## Install OneSpan Wallet > OneSpan Wallet requires other DigipassONE components to function and should only be used to explore and validate digital credential functionality. It is currently not intended for standalone use. 1. On your mobile device, open a browser and go to [https://testflight.apple.com/join/4Fbgbtyk](https://testflight.apple.com/join/4Fbgbtyk). You will be presented with two steps. 2. If you do not yet have *TestFlight*, proceed with **Step 1: Get TestFlight** and install the app by clicking **View in App Store**. 3. Then, proceed to **Step 2: View OneSpan Wallet Beta** and click **View in TestFlight**. 4. Once *OneSpan Wallet* is visible, click **OPEN**. 5. When prompted, create a 6-digit passcode. 6. You may also be asked to **Enable Face ID**. You can choose to enable this or not. 7. You may also be asked to *Allow “OneSpan Wallet” to find devices on local networks?* Click **Don’t Allow**. 8. You should see a notification indicating that your wallet is ready. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-onespan-wallet-ios-wallet-ready.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=8WOasFHtS25qNvvWWncUOvNhayY2hW5WASVVAWIZ%2F98%3D) ## Download the iOS 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 **iOS 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%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=ZYS91oAOJ4p4bWELplvEHcl1K%2BsJXG5sGKKY3%2BeP5U4%3D) 3. Download the zip file. ## Build the iOS tutorial app ### Enable Touch ID authentication 1. Launch **Xcode** and open the folder where you downloaded the iOS App SDK. 2. Navigate to *TutorialAppPlus > TutorialAppPlus* and double-click **TutorialAppPlus.xcodeproj**. 3. Set your **Bundle Identifier** in the *General tab* in the Tutorial App. 4. Connect a Touch ID-capable device to your build machine. 5. Set the connected iOS device as the target. 6. Press the **play button** to build and run the iOS tutorial app on your device. ## Connect the iOS tutorial app to your tenant ### Get the configuration settings 1. On your computer, open a browser and navigate to `https://preview.digipassone.com/<tenant>/webapps/demo/gwtutorial/configure`. 2. Replace `<tenant>` in the above URL with your tenant name.1 3. On the **Web App Configuration** page, ensure that the **Configuration Version** is set to *automatic*. 4. Click **Apply Configuration**. ![Web app configuration settings including tenant, server host, and apply configuration button.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-S3-auth-cloud-android-web-app-config(2).png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=aikpT1rt%2BlOMvYoGTW8%2FxcoebYNRdnTJ2FP1WfvXgzU%3D) 5. Next, click **Show QR Code**. You should see the *Configuration QR code dialog*. ![Scan this QR code to apply the configuration using your application.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-S3-auth-cloud-web-app-config-qr-code(4).png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=VLOMoalXXom6T9PxUJ6JrtzewHRlYnW23dg60gxXxpc%3D) 6. Make sure that you keep your browser window open. > 1 Your tenant name appears at the top of the portal. ### Configure the iOS tutorial app 1. Open the *iOS tutorial app* and click on the menu icon in the upper left. 2. Choose the **Scan QR Code** menu item. 3. Scan the *Configuration QR code* on your browser from Step 5 of [Get the configuration settings](/dpoa/docs/dpo-verify-implement-digital-credentials-with-the-ios-tutorial-app#get-the-configuration-settings). 4. You should see a notification saying, *Configuration updated* once the Tutorial app connects to your tenant. ## Test the iOS tutorial app ### Register a digital credential 1. Open the *iOS tutorial app* and login with any username and click **Next**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-tutorial-app-ios-login.PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=m5moMFBR243ZLbQt9Ge2ztlZHNew1G8BHCrlMrDNxKo%3D) 2. Enter *"noknok”* as the password and click **Next**. - Click **Not Now** if you are asked to set up FIDO Auth, Mobile Device, Email or SMS. 3. On the *Setup dialog*, click **Digital Credential**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-tutorial-app-ios-setup-passkey_updated.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=NmmhiG32OjZGq0LAuMIfYh8sU%2BerIf4JCOQafz7lJes%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/screenshot-tutorial-app-ios-issue-dc-confirmation.PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=x2YaP%2BK4JrLwnxgKxoai1K6kedy%2BjX%2BAnJPv7d6s60I%3D) 5. You will be asked to enter a passcode to access **OneSpan Wallet**. 6. You will see the notification, *Credential offer received*, along with the credential code. 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. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-tutorial-app-ios-cred-offer-received_blurred.PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=OsPObDyD5WcPyhpD0gXQQovVqfNHBeYBEhWuEcJhIf0%3D) 7. You should now see the *Add credential dialog*, which shows the new credential and the metadata that will be shared during authentication. Click **Confirm**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-tutorial-app-ios-add-credential_blurred.PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=%2BeYuJvoQb%2Ftca6MpTrZ0B4QGxKf4TNE50waaGbn8%2Bps%3D) 8. You should see a *Credential added* notification, and the credential should be visible at the bottom of the screen. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-tutorial-app-ios-credential-added_blurred.PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=hMdW52Tlq9UdlC8kP0fNCZRYRefMGp2hjeHhbK1fUhw%3D) 9. Navigate back, or switch to the iOS Tutorial App. You should see the new credential at the bottom of the *Register screen*. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-tutorial-app-ios-with-cred(3).PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=VQ1VYCO2ojB1df5bKLlBob4bGxTliTZBe%2BRvdtMpVoI%3D) ### Login with a digital credential 1. First make sure that you have signed out of the iOS Tutorial App. 2. Next, login with your username and 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/screenshot-tutorial-app-signin-with-dc.PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=HKljDP4x7%2FGhLna1IXGIUVUPI7Yo1Xp2cbI5WDEjOd8%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/screenshot-tutorial-app-verify-dc.PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=JVtrhcxi%2BeakKuXkHndHQvawzycOKi4bcFsU1z2aRk4%3D) 5. You may be asked to enter your passcode or authenticate through other means. 6. You should see a notification for *Presentation request received*, and the credential will be displayed at the bottom of the screen. Click **Present**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-onespan-wallet-ios-presentation-received_blurred.PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=FQUfEkT1l99YViDXjBV1hYNX%2F0kguZfoxXARvR3ngSU%3D) 7. Press **Confirm** on the *Share credentials dialog*. - If you have more that one credential, you will be asked to select one before clicking **Confirm**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-onespan-wallet-ios-share-cred_blurred.PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=0nXuua71lqt%2BJej%2BuW%2FZ7FbEG1V0XysUeC5tLXnBVbY%3D) 8. You will see the notification, *Presentation sent*. 9. Navigate or switch back to the iOS Tutorial App. You should see a Welcome message with your login name on the *Register page*. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-tutorial-app-ios-with-cred(4).PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=h%2B%2BsR5XLf52hJqpwlzeL9VHt3jyAdsuXkpaJuitNo8k%3D) ### Authenticate a transaction with a digital credential 1. Open the Tutorial app menu and click **Transaction**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-tutorial-app-ios-menu.PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=ej5bppbG2kvC9UyRZvGEvSO4HJrq0z7HFmqwXLVVxLs%3D) 2. On the *Transaction* screen, enter an amount in the field provided and click **Next**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-tutorial-transaction.PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=iPas%2BZw6MEmsu%2Fmm3Q967v2Bjq4DNbO668Mf9kQLBFU%3D) 3. Click **Authorize** to proceed with the transaction. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-tutorial-ios-authorize-payment.PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=VIyNhWhzBQbxN%2BTJDYsmN3Ng3DA1AD3orJJHkbaZDuk%3D) 4. On the *Authorize screen*, click **Authorize**. 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/screenshot-tutorial-ios-verify-transaction-with-dc.PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=4EncEPQpMzsidTCObxCpxhimqeUraU71fb1V10sD6cg%3D) 6. If requested, enter your passcode or Face ID if it is enabled in the Wallet. 7. You will see the notification, *Presentation request received*, with the credential displayed at the bottom of the screen. Click **Present**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-onespan-wallet-ios-presentation-received_transaction_blurred.PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=sLaetZI1OonNRJTkhzz0RKBGzO01UHhYnjRQwH2HIVQ%3D) 8. Verify the transaction details and click **Confirm** on the *Share credentials dialog*. - If you have more that one credential, you will be asked to select one before clicking **Confirm**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-onespan-wallet-ios-transactions-share-cred_blurred.PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=zvdWbuoOGjenGw%2BIRRevxk25UGXMT9vjn0OQUbaUl34%3D) 9. You will see the notification, *Presentation sent*. 10. Navigate or switch back to the iOS Tutorial App. You should see a *Transaction succeeded* message on the *Transaction page*. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-tutorial-ios-transaction-suceeded(1).png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=J4UJaZDa6flqIH3SdTxjW8GZaH45RcVXRyOE1X24Z5A%3D) ### Remove a digital credential from the iOS tutorial app 1. Open the iOS Tutorial app and navigate to the *Register page*. 2. Your credential(s) should be listed at the bottom of the screen. Click on the **trash can** to delete it from the app. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-tutorial-app-ios-with-cred(5).PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=zea%2FruLrOR9Jns4pc5GqyHGlkxf81IrARnzWUcCPtdE%3D) 3. You will be asked to confirm the credential’s removal. Click **Yes**. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-tutorial-ios-remove-dc(1).PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=fFtbjP4cZQ%2B%2BYir6GKEQZ6LvgyPt7LzzMBaDawfyzY8%3D) 4. The Register page will no longer display the credential. ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-tutorial-app-ios-register-screen-no-cred.PNG?sv=2026-02-06&spr=https&st=2026-11-18T19%3A16%3A01Z&se=2026-11-18T20%3A16%3A01Z&sr=b&sp=r&sig=OPHxJkzUBxgINXFtYfntSF7o6a1dDD0iADB1J3BQJpI%3D) > Removing a digital credential from the Tutorial app will not remove it from OneSpan Wallet. Formerly known as Digipass S3 App SDK. Includes SDKs for Android, iOS and web. Formerly known as Digipass S3.