--- title: "Implement passkeys on the iOS Tutorial App" slug: "dpo-authenticate-implement-passkeys-on-the-ios-tutorial-app" tags: ["S3 v9.5"] updated: 2026-10-27T16:01:25Z published: 2026-10-27T16:01:25Z canonical: "docs.onespan.com/dpo-authenticate-implement-passkeys-on-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 passkeys on the iOS Tutorial App | Requirements | | --- | | IDE | Xcode 26.0 or later | | Computer | Mac OS X 26 or later | | Device | Touch ID capable device running iOS 14 or later | | Other | - Apple Developer account - Unique bundle ID1 | > 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). ## Download the iOS SDK 1. Login to the [DigipassONE Authenticate Cloud portal](https://staging.digipassone.com/). 2. Locate the **Software Downloads** tile. ![List of software downloads including Cordova, Web, and iOS SDK options.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-S3-cloud-software-downloads(2).png?sv=2026-02-06&spr=https&st=2026-10-29T01%3A37%3A17Z&se=2026-10-29T02%3A37%3A17Z&sr=c&sp=r&sig=zKg7ZsWeJ6WQU2DptQx1KI7dEGYfYF37umbdDgWNp4s%3D) 3. Click **iOS SDK** and download the zip file. ![Interface for downloading various SDKs including Cordova, Web, iOS, and Android.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-S3-cloud-download-app-sdks(2).png?sv=2026-02-06&spr=https&st=2026-10-29T01%3A37%3A17Z&se=2026-10-29T02%3A37%3A17Z&sr=c&sp=r&sig=zKg7ZsWeJ6WQU2DptQx1KI7dEGYfYF37umbdDgWNp4s%3D) ## Review the iOS tutorial app settings Learn how the iOS tutorial app is configured in the server to see how your own client application would be set up. 1. Open the **Configuration** menu and click **Apps**. ![OneSpan dashboard showing signed-in user and navigation options for applications.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-S3-auth-cloud-config-apps(1).png?sv=2026-02-06&spr=https&st=2026-10-29T01%3A37%3A17Z&se=2026-10-29T02%3A37%3A17Z&sr=c&sp=r&sig=zKg7ZsWeJ6WQU2DptQx1KI7dEGYfYF37umbdDgWNp4s%3D) 2. On the *Apps* page, search for **Nok Nok Tutorial for iOS** and click the **Edit** icon. ![List of apps with highlighted tutorial and edit action options displayed.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-S3-auth-cloud-config-apps-iOS.png?sv=2026-02-06&spr=https&st=2026-10-29T01%3A37%3A17Z&se=2026-10-29T02%3A37%3A17Z&sr=c&sp=r&sig=zKg7ZsWeJ6WQU2DptQx1KI7dEGYfYF37umbdDgWNp4s%3D) 3. You should see a page with the settings for *Nok Nok Tutorial for iOS*: - **Package Name/URL**: ios:com.noknok.ios.tutorialappplus *This name cannot be changed.* - **App Name**: Nok Nok Tutorial for iOS *The app name displayed in the Server Console.* - **Facet ID**2 *FIDO UAF* is checked, so **FIDO UAF Facet ID** will be available. - **Adaptive Ruleset**: tutorial3 *Sets the authentication flow based on the user's device and their response to challenges.* - **Supported OOB Modes**: *Specifies what will be sent to users with out-of-band authentication.* - **QR Code** - **Push notification** - **Use Token Signing Key** - **Token Signing Key** - **Handle for Token Signing Key:** {default}store - **Use APNs Production Server**: (checked) ![App configuration settings including package name, team ID, and supported modes.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-S3-auth-cloud-config-apps-ios-settings.png?sv=2026-02-06&spr=https&st=2026-10-29T01%3A37%3A17Z&se=2026-10-29T02%3A37%3A17Z&sr=c&sp=r&sig=zKg7ZsWeJ6WQU2DptQx1KI7dEGYfYF37umbdDgWNp4s%3D) 4. Once you have reviewed the iOS tutorial app settings, you should also: 1. Navigate to *Configuration > Authentication Methods* 2. Open **FIDO2/WebAuthn** and ensure that **RP ID** is not set to *localhost* but to *http://staging.digipassone.com.* > 2 The Facet ID depends on the bundle ID key which you have assigned. 3 Set to *tutorial* to apply rules for the Tutorial app. To see which rules would be applied, access the link, *Click here to view Ruleset*. ## 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 DigipassONE Authenticate Cloud 1. On your computer, open a browser and append this to the Authentication Cloud base URL *//webapps/demo/gwtutorial/configure* with ** being your tenant name.4 2. On the **Web App Configuration** page, ensure that the **Configuration Version** is set to *automatic.* 3. 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.png?sv=2026-02-06&spr=https&st=2026-10-29T01%3A37%3A17Z&se=2026-10-29T02%3A37%3A17Z&sr=c&sp=r&sig=zKg7ZsWeJ6WQU2DptQx1KI7dEGYfYF37umbdDgWNp4s%3D) 4. Next, click **Show QR Code**. You should see the *Configuration QR code dialog*. ![A QR code for configuration, with instructions to scan using an application.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-S3-auth-cloud-web-app-config-qr-code(2).png?sv=2026-02-06&spr=https&st=2026-10-29T01%3A37%3A17Z&se=2026-10-29T02%3A37%3A17Z&sr=c&sp=r&sig=zKg7ZsWeJ6WQU2DptQx1KI7dEGYfYF37umbdDgWNp4s%3D) 5. Launch the *iOS Tutorial app* on your device. 6. Click **Scan QR Code** from the top left menu to connect the iOS tutorial app to your tenant. > 4 Your tenant name appears in the header of the portal. ## Test the iOS tutorial app 1. Open the *iOS tutorial app* and enter your username in the field provided. Click **Next**. ![OneSpan login screen with options to sign in or sign up for users.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-S3-ios-tutorial-sign-in.PNG?sv=2026-02-06&spr=https&st=2026-10-29T01%3A37%3A17Z&se=2026-10-29T02%3A37%3A17Z&sr=c&sp=r&sig=zKg7ZsWeJ6WQU2DptQx1KI7dEGYfYF37umbdDgWNp4s%3D) 2. When you are prompted for a *Password*, enter *"noknok."* Click **Next**. ![OneSpan app login screen with fields for username and navigation buttons.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-S3-ios-tutorial-password.PNG?sv=2026-02-06&spr=https&st=2026-10-29T01%3A37%3A17Z&se=2026-10-29T02%3A37%3A17Z&sr=c&sp=r&sig=zKg7ZsWeJ6WQU2DptQx1KI7dEGYfYF37umbdDgWNp4s%3D) 3. You will be asked to set up authentication. Register a passkey by clicking **FIDO Auth**. ![OneSpan app setup options include FIDO Auth, Mobile Device, and Email or SMS.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-S3-ios-tutorial-fido-auth.PNG?sv=2026-02-06&spr=https&st=2026-10-29T01%3A37%3A17Z&se=2026-10-29T02%3A37%3A17Z&sr=c&sp=r&sig=zKg7ZsWeJ6WQU2DptQx1KI7dEGYfYF37umbdDgWNp4s%3D) 4. You will be presented with various options to register a passkey. Choose one and follow the instructions: 1. Platform authenticator 2. Security Key 3. Face ID 4. Passcode 5. PIN 6. Yes/No 7. Watch 8. Device ![User registration screen displaying various authentication options and settings for security features.](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/screenshot-S3-ios-tutorial-sign-in-methods.PNG?sv=2026-02-06&spr=https&st=2026-10-29T01%3A37%3A17Z&se=2026-10-29T02%3A37%3A17Z&sr=c&sp=r&sig=zKg7ZsWeJ6WQU2DptQx1KI7dEGYfYF37umbdDgWNp4s%3D) 5. Once you have registered all your preferred methods, log out. 6. Test your passkey. Sign in with the username, click **Next** and authenticate using one of the methods you selected. 7. If you are able to sign in, log out again and sign in using another method until you have tested them all. > You can now proceed to [Adding your iOS application to the DigipassONE Authentication Cloud](/dpoa/docs/adding-your-ios-application-to-the-authentication-cloud). Formerly Digipass S3 Cloud.