Skip to content

Add MFA docs and session profiles to new docs structure - #710

Open
grahamritter wants to merge 5 commits into
mainfrom
mfa-sessions-new-structure
Open

Add MFA docs and session profiles to new docs structure#710
grahamritter wants to merge 5 commits into
mainfrom
mfa-sessions-new-structure

Conversation

@grahamritter

Copy link
Copy Markdown
Contributor

Summary

  • Ports MFA and session profiles content from Mfa docs #619 to the current docs structure (features/authentication/)
  • Adds 4 MFA pages: overview, satisfying MFA, enforcement & recovery, examples
  • Adds session profiles page and converts sessions.mdx to sessions/overview.mdx with scoped sessions section
  • Updates docs.json navigation with Sessions and MFA groups under Authentication
  • Fixes all cross-references site-wide to use updated session paths
  • Adds redirects for old session URLs

Context

PR #619 was written against the old authentication/ structure. This PR adapts that content to the current features/authentication/ structure on main, with corrected internal links throughout.

Test plan

  • Verify local Mintlify preview renders all new pages
  • Check sidebar navigation shows Sessions and MFA groups under Authentication
  • Confirm all internal links resolve (no 404s)
  • Verify redirects from old /authentication/sessions and /features/authentication/sessions paths

🤖 Generated with Claude Code

Graham Ritter and others added 4 commits August 17, 2026 14:16
Ports content from PR #619 (amir/mfa-docs) to the current docs structure:
- Add MFA pages: overview, satisfying-mfa, enforcement-and-recovery, examples
- Add session profiles page
- Convert sessions.mdx to sessions/overview.mdx with scoped sessions section
- Update docs.json navigation with Sessions and MFA groups
- Fix all cross-references to use features/authentication/sessions/overview
- Add redirects for old session paths
- Fix internal links to use current paths (features/policies/, api-reference/, etc.)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@moeodeh3
moeodeh3 force-pushed the mfa-sessions-new-structure branch from d4c3f0c to 03900bf Compare August 17, 2026 18:20
activity.resource == 'MFA_POLICY' && activity.action == 'DELETE'
```

With this setup, when a user is locked out, you can verify their identity through your own process and then delete the MFA policy using the DA user to restore access.

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.

nit: i assume somewhere else we have DA means delegated access, but it might be worth mentioning that DA abbreviates from delegated access.

we also switch between DA and delegated access user a lot in this doc, is there a reason or should we mention once and inform the abbreviation and use the abbreviation throughout?

]
}
],
order: 0,

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.

nit: we mention userId: "<target-user-id>", // Required: the user this MFA policy applies to
would it be useful to have a comment on this order so people know its the order they apply in?

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.

3 participants