high complexity extracted Profile Management Confidence: 100%
8
Components
106
Shared
0
User Stories
Yes
Analyzed

Description

This feature enables users to register and use FIDO2 passkeys as an authentication method, providing a phishing-resistant, passwordless login experience backed by device biometrics or hardware security keys. The Passkey Setup Screen guides users through the passkey registration flow using the platform authenticator APIs on iOS (Sign in with Apple passkeys) and Android (Credential Manager). Once registered, passkeys can be used as the primary or supplementary authentication method on subsequent logins without requiring a password entry.

User Flow

Authentication Methods (Passkeys) user flow
Click to expand

Analysis

Business Value

Passkeys represent the modern standard for secure, user-friendly authentication and directly address the platform's accessibility and usability requirements. For peer mentors with motor impairments or cognitive challenges — a core constituency across NHF, Blindeforbundet, and HLF — eliminating the password entry step reduces login friction substantially. From a security perspective, passkeys are immune to phishing and credential stuffing attacks, reducing the risk of unauthorized access to sensitive peer mentor and contact data. Adopting passkeys positions Meander as a security-forward platform aligned with current FIDO Alliance and W3C WebAuthn standards, which is increasingly expected by enterprise and public-sector customers.

Implementation Notes

The Passkey Auth Service integrates with the Flutter local_auth and credential_manager packages to interact with the platform's FIDO2 authenticator APIs. The backend REST API must implement WebAuthn registration and authentication ceremonies, storing public key credentials per user in the database. The setup flow uses a guided wizard pattern on the Passkey Setup Screen with clear explanations of what a passkey is, minimizing cognitive load for less technical users. Error handling must cover scenarios where the device does not support passkeys, falling back gracefully to existing authentication methods. WCAG 2.2 AA compliance applies throughout: all prompts, dialogs, and confirmations must be screen-reader accessible and support keyboard navigation on devices where applicable.

Components (114)

User Interface (2)

Service Layer (2)

Data Layer (2)

Infrastructure (2)

Shared Components

These components are reused across multiple features

Service Layer (34)

Data Layer (22)

Infrastructure (38)

infrastructure Keychain/Keystore Adapter low Shared infrastructure JWT Claims Extractor low Shared infrastructure Organization Labels Adapter low Shared infrastructure Keychain/Keystore Adapter low Shared infrastructure Auth API Client medium Shared infrastructure REST API Client medium Shared infrastructure WCAG Accessibility Adapter low Shared infrastructure Registration API Client low Shared infrastructure Accounting API Client high Shared infrastructure PDF Renderer Adapter medium Shared infrastructure File Share Adapter low Shared infrastructure FCM/APNs Adapter high Shared infrastructure Share Sheet Adapter low Shared infrastructure Share Plus Adapter low Shared infrastructure Platform Accessibility Bridge medium Shared infrastructure Semantics Override Adapter high Shared infrastructure URL Launcher Adapter low Shared infrastructure Markdown Content Renderer low Shared infrastructure Network Connectivity Monitor low Shared infrastructure Expense Receipt Storage Adapter low Shared infrastructure Audit Log Writer low Shared infrastructure Feature Flag Checker low Shared infrastructure Logo Upload Adapter low Shared infrastructure Terminology Constants Registry low Shared infrastructure Feature Flag Cache Adapter low Shared infrastructure Org Scope JWT Resolver medium Shared infrastructure Association Audit Logger low Shared infrastructure Token Blocklist medium Shared infrastructure Analytics Tracker low Shared infrastructure SEO Metadata Config low Shared infrastructure Analytics Tracker low Shared infrastructure Analytics Tracker low Shared infrastructure Sales Analytics Tracker low Shared infrastructure Email Provider Adapter low Shared infrastructure Terms of Service Content Provider low Shared infrastructure Legal PDF Asset Provider low Shared infrastructure Consent-Gated Script Loader low Shared infrastructure Legal Page Layout low Shared

User Stories

No user stories have been generated for this feature yet.