Skip to content

feat(auth): make each MFA enrollment step a real navigation destination - #2467

Merged
russellwheatley merged 1 commit into
version-10.0.0-beta05from
feat/mfa-enrollment-per-step-nav
Sep 2, 2026
Merged

feat(auth): make each MFA enrollment step a real navigation destination#2467
russellwheatley merged 1 commit into
version-10.0.0-beta05from
feat/mfa-enrollment-per-step-nav

Conversation

@demolaf

@demolaf demolaf commented Sep 1, 2026

Copy link
Copy Markdown
Member

MFA enrollment kept its four steps in local composable state, so onBackClick hand-rolled a back stack by inspecting the selected factor, and backing out of SMS enrollment discarded the phone number the user had typed. Each step is now its own destination, so system back walks them and entered data survives.

Cross-step state moves into a MfaEnrollmentFlowState holder above the NavHost, with hand-written Savers so the SMS session and selected country survive Activity recreation. A TOTP secret can't survive one — the SDK's TotpSecret is an interface with no public reconstruction path — so a lost secret is now regenerated with a fresh QR code and an explanatory message, rather than leaving the user on an opaque "No TOTP secret available" error.

  • MfaEnrollmentDestinations.kt: shared graph extension registering the four steps, plus mfaEnrollmentStartStep so a single-allowed-factor config resolves its start step at flow entry instead of auto-advancing past SelectFactor.
  • MfaEnrollmentScreen: gained step/onNavigateToStep/onNavigateBack/flowState as a required set (a partial subset throws at composition); a null step preserves today's standalone behaviour.

Added MfaEnrollmentRouteNavigationTest, MfaEnrollmentFlowStateRestorationTest and MfaEnrollmentTotpRegenerationTest — data preservation across step switches and recreation, back-stack ordering, and TOTP regeneration.

Usage

val flowState = rememberMfaEnrollmentFlowState()
NavHost(...) {
    mfaEnrollmentDestinations(navController, configuration, /**/ flowState = flowState)
}

Maintainer note: Fixes internal CPRN-403

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request refactors the MFA enrollment flow to host steps as real navigation destinations, ensuring state survives step transitions and Activity recreation. This is achieved by introducing MfaEnrollmentFlowState and custom savers for CountryData and SmsEnrollmentSession. Feedback on the changes highlights a potential security risk of cross-user state leakage, suggesting that rememberMfaEnrollmentFlowState be keyed on the user's ID. Additionally, it is recommended to wrap a composition-time popBackStack() call in a LaunchedEffect to avoid side-effects during composition.

@demolaf
demolaf force-pushed the feat/mfa-enrollment-per-step-nav branch from 84abce8 to 4d4fe41 Compare September 2, 2026 01:10
@demolaf
demolaf force-pushed the feat/mfa-enrollment-per-step-nav branch from 4d4fe41 to 548c396 Compare September 2, 2026 13:17
@demolaf
demolaf force-pushed the feat/mfa-enrollment-per-step-nav branch from 548c396 to a38bb4f Compare September 2, 2026 13:30
Base automatically changed from feat/auth-per-step-nav-destinations to version-10.0.0-beta05 September 2, 2026 14:23
@russellwheatley
russellwheatley force-pushed the feat/mfa-enrollment-per-step-nav branch from a38bb4f to bfc6583 Compare September 2, 2026 14:23
@russellwheatley
russellwheatley merged commit bfc90ec into version-10.0.0-beta05 Sep 2, 2026
9 checks passed
@github-project-automation github-project-automation Bot moved this from Backlog to Done in studio-2394994192-60a69 Sep 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants