-
-
Notifications
You must be signed in to change notification settings - Fork 48
chore: add adaptive MFA doc #1356
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: master
Are you sure you want to change the base?
Conversation
Deploying logto-docs-tutorials with
|
| Latest commit: |
01d2f65
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://03798eab.logto-docs-tutorials.pages.dev |
| Branch Preview URL: | https://yemq-log-12904-add-adaptive.logto-docs-tutorials.pages.dev |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Pull request overview
This PR adds documentation for a new Adaptive MFA feature to the MFA configuration guide. Adaptive MFA is an additional security layer that triggers MFA verification only when sign-in behavior appears unusual, helping balance user experience with security.
Changes:
- Added a new "Adaptive MFA" subsection to the Global MFA configuration documentation
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
|
||
| <img src="/img/assets/configure-mfa.png" alt="MFA settings" /> | ||
|
|
||
| ### Adaptive MFA |
Copilot
AI
Feb 5, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The heading is missing an anchor ID. All other level 3 headings in this document follow the pattern of including an anchor ID in the format \{#anchor-id}. For consistency with the existing documentation structure, this heading should include an anchor ID, such as \{#adaptive-mfa}.
| ### Adaptive MFA | ||
|
|
||
| Adaptive MFA is an additional security layer that can be enabled separately from standard MFA. It relies on your existing MFA setup (at least one MFA factor must be enabled) and only asks for MFA when sign-in behavior appears unusual. This helps balance user experience and security by applying extra verification only when needed. Adaptive MFA applies to end-user sign-in flows and does not rely on device fingerprinting or other sensitive personal data. | ||
|
|
Copilot
AI
Feb 5, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This section describes what Adaptive MFA is but does not include configuration steps on how to enable or configure it. Other sections in this document (like "Global MFA configuration" at line 11 and "Organization-level MFA configuration" at line 41) include step-by-step instructions for configuration. Consider adding similar instructions for Adaptive MFA to maintain consistency with the documentation structure and to help users actually implement this feature. If the configuration steps are not yet available or are documented elsewhere, consider adding a note or link to guide users.
| To enable Adaptive MFA in Logto: | |
| 1. Navigate to: <CloudLink to="/mfa">Console > Multi-factor auth</CloudLink>. | |
| 2. Make sure at least one primary MFA factor is enabled in the **MFA factors** section. | |
| 3. In the **Adaptive MFA** section on the same page, toggle **Enable Adaptive MFA**. | |
| 4. Save your changes. |
Deploying logto-docs with
|
| Latest commit: |
01d2f65
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://b65b3c29.logto-docs.pages.dev |
| Branch Preview URL: | https://yemq-log-12904-add-adaptive.logto-docs.pages.dev |
Summary
add adaptive MFA doc