# Use Case 2.1 Setup a remote PIN and biometric unlock

## Overview

| Aspect                       | Description                                                                                                                                                                                                                                                                                                                                                                                                           |
|------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Summary**                  | The user chooses and confirms a secure 6-digit remote Personal Identification Number (PIN) for the app, enables biometric unlock if supported and desired, and receives a notification code.                                                                                                                                                                                                                          |
| **Goal**                     | Securing the App with PIN and optionally biometrics and receive a revocation code.                                                                                                                                                                                                                                                                                                                                    |
| **Preconditions**            | *None*                                                                                                                                                                                                                                                                                                                                                                                                                |
| **Postconditions**           | <ul><li>Remote PIN is configured.</li><li>If selected, biometric unlock is configured.</li></ul>                                                                                                                                                                                                                                                                                                                      |
| **Triggered by**             | <ul><li>User completes [UC1.1 Introduce the app](UC1.1_IntroduceTheApp.md)</li></ul>                                                                                                                                                                                                                                                                                                                                  |
| **Additional Documentation** | <ul><li>[Wallet creation](../../architecture/use-cases/wallet-creation)</ul></li>                                                                                                                                                                                                                                                                                                                                     |
| **Possible errors**          | *None*                                                                                                                                                                                                                                                                                                                                                                                                                |
| **Logical Test Cases**       | <ul><li>[LTC51 Setup PIN](../logical-test-cases.md#ltc51)</li><li>[LTC52 Setup PIN fails device does not pass app and key attestation](../logical-test-cases.md#ltc52)</li><li>[LTC58 Skip setting up biometrics](../logical-test-cases.md#ltc58)</li><li>[LTC59 Device does not support biometrics](../logical-test-cases.md#ltc59)</li><li>[LTC70 Receive revocation code](../logical-test-cases.md#ltc70)</li>/ul> |

---

## Flow

| #       | Description                                                                                                                                                                               | Next                                                           |
|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------|
| **1**   | **PRIMARY SCENARIO**                                                                                                                                                                      |                                                                |
| **1.1** | **System executes partial flow [PF2.9 Setup PIN](../partial-flows/PF2.9_SetupPin.md)**                                                                                                    |                                                                |
| 1.1a    | Result: PIN setup succeeds                                                                                                                                                                | 1.2                                                            |
| 1.1b    | Result: Back                                                                                                                                                                              | Back                                                           |
| **1.2** | **System determines whether device supports biometrics**<ul><li>Duration: 0.0 - 0.1 seconds</li></ul>                                                                                     |                                                                |
| 1.2a    | Case: Device supports biometrics                                                                                                                                                          | 1.7                                                            |
| 1.2b    | Case: Device does not support biometrics                                                                                                                                                  | 1.9                                                            |
| **1.3** | **System displays screen 'Configure Biometrics'**<ul><li>Message: Do you want to unlock the app with Face ID/Fingerprint?</li><li>Actions: Enable, Skip, Info</li></ul>                   |                                                                |
| 1.3a    | User selects Enable                                                                                                                                                                       | 1.9                                                            |
| 1.3b    | User selects Skip                                                                                                                                                                         | 1.9                                                            |
| 1.3c    | User selects Info                                                                                                                                                                         | Go to: [UC9.2 Get app information](UC9.2_GetAppInformation.md) |
| **1.4** | **Operating system prompts user for biometric authentication**                                                                                                                            |                                                                |
| 1.4a    | User confirms with biometric authentication                                                                                                                                               | 1.9                                                            |
| 1.4b    | User rejects biometric authentication                                                                                                                                                     | 1.7                                                            |
| **1.5** | **System displays screen 'Confirm PIN/biometric setup'**<ul><li>Message: Your NL Wallet is secured</li><li>Actions: Next</li></ul>                                                        |                                                                |
| 1.5a    | User selects Next                                                                                                                                                                         | 1.6                                                            |
| **1.6** | **System displays screen 'Write down deletion code'**<ul><li>Message: You use this code to delete your NL Wallet from a distance.</li><li>Actions: I have written it down, Help</li></ul> |                                                                |
| 1.6a    | User selects I have written it down                                                                                                                                                       | Go to: [UC3.1 Obtain PID](UC3.1_ObtainPidFromProvider.md)      |
| 1.6b    | User selects Help                                                                                                                                                                         | Show placeholder 'under construction'                          |