🏠 Overview › 👥 User Roles ›📖 Enroll Device Biometrics After First Login

Enroll Device Biometrics After First Login

After a successful first-time BankID or Vipps authentication, the app prompts the user to enable biometric re-authentication. If the user consents, the Biometric Auth Service uses Flutter's local_auth package to perform a biometric enrollment challenge. On success, an encrypted reference to the active Supabase session token is stored in Flutter Secure Storage via the Auth Token Repository. The Biometric Auth Screen handles the enrollment UI, shows platform-appropriate guidance (Face ID on iOS, fingerprint on Android), and communicates the outcome clearly. The user can skip enrollment and be prompted again on subsequent logins.

HIGH story-bankid-vipps-authentication-organization-administrator-003 5 pts
5
Story Points
High
Priority
BankID & Vipps Authentication
Feature

User Story

As a user
I want to enable Face ID or fingerprint authentication on my device after completing my first BankID or Vipps login
So that So that subsequent app sessions require only a quick biometric scan instead of going through the full BankID or Vipps flow every time

Acceptance Criteria

  • Given a user who has just completed their first BankID or Vipps login, when the session is established, then the app presents a biometric enrollment prompt with a clear explanation of its purpose
  • Given a user who accepts biometric enrollment, when they complete the biometric challenge successfully, then an encrypted token reference is stored in Flutter Secure Storage and enrollment is confirmed
  • Given a user who declines biometric enrollment, when they dismiss the prompt, then the app proceeds to the home screen without enrolling and does not repeatedly prompt during the same session
  • Given a device where biometrics are not enrolled at the OS level, when the app attempts to offer biometric enrollment, then it displays a message directing the user to set up Face ID or fingerprint in device settings
  • Given a device that does not support biometrics, when the enrollment prompt would normally appear, then it is silently skipped and BankID/Vipps becomes the only authentication path
  • Given a user who enrolls biometrics, when they subsequently open the app, then the biometric prompt appears instead of the BankID/Vipps selection screen

Business Value

Peer mentors log activities multiple times per day — every additional second of authentication friction directly contributes to underreporting, which is the primary problem the app solves. Biometric enrollment after first login reduces the daily authentication burden from a 15-30 second BankID/Vipps flow to a sub-second Face ID or fingerprint scan, dramatically improving usability for repeat users and reducing drop-off on activity registration.

Components

BankID & Vipps Authentication
Related Feature
Organization Administrator
User Role