Skip to content

First updates for Advanced Factor Config - #1678

Open
avanscoy wants to merge 8 commits into
mainfrom
feat/docs-5417-AFC
Open

First updates for Advanced Factor Config#1678
avanscoy wants to merge 8 commits into
mainfrom
feat/docs-5417-AFC

Conversation

@avanscoy

@avanscoy avanscoy commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Description

Update existing pages with AFC, Code Length and Code Lifetime

References

Testing

Checklist

  • I've read and followed CONTRIBUTING.md.
  • I've tested the site build for this change locally.
  • I've made appropriate docs updates for any code or config changes.
  • I've coordinated with the Product Docs and/or Docs Management team about non-trivial changes.

@avanscoy
avanscoy requested a review from a team as a code owner August 5, 2026 19:37
@avanscoy avanscoy added main-docs Changes related to auth0's main docs (https://auth0.com/docs) DO NOT MERGE Only the PR author should merge, even if approved. labels Aug 5, 2026
@mintlify

mintlify Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
auth0 🟢 Ready View Preview Aug 5, 2026, 7:43 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@mintlify

mintlify Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
auth0-docs-dev 🟢 Ready View Preview Aug 5, 2026, 7:43 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@mintlify

mintlify Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
auth0-docs-staging 🟢 Ready View Preview Aug 5, 2026, 7:44 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions

github-actions Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Summary

Status Count
🔍 Total 274
✅ Successful 26
⏳ Timeouts 0
🔀 Redirected 13
👻 Excluded 224
❓ Unknown 0
🚫 Errors 11
⛔ Unsupported 0

Errors per input

Errors in main/docs/secure/multi-factor-authentication/auth0-guardian.mdx

Errors in main/docs/secure/multi-factor-authentication/auth0-guardian/guardian-for-android-sdk.mdx

Errors in main/docs/secure/multi-factor-authentication/multi-factor-authentication-factors/configure-sms-voice-notifications-mfa.mdx

Redirects per input

Redirects in main/docs/secure/multi-factor-authentication/auth0-guardian/guardian-for-android-sdk.mdx

Redirects in main/docs/secure/multi-factor-authentication/authenticate-using-ropg-flow-with-mfa/enroll-challenge-sms-voice-authenticators.mdx

Redirects in main/docs/secure/multi-factor-authentication/configure-cisco-duo-for-mfa.mdx

Redirects in main/docs/secure/multi-factor-authentication/manage-mfa-auth0-apis/manage-authenticator-factors-mfa-api.mdx

Redirects in main/docs/secure/multi-factor-authentication/multi-factor-authentication-factors/configure-sms-voice-notifications-mfa.mdx

Redirects in main/docs/secure/multi-factor-authentication/step-up-authentication/configure-step-up-authentication-for-web-apps.mdx

BcnCarlos
BcnCarlos previously approved these changes Aug 18, 2026
BcnCarlos
BcnCarlos previously approved these changes Aug 21, 2026

@andy317fe301f8c7 andy317fe301f8c7 left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Reviewed against the current head commit and cross-checked the OTP/remember-me ranges directly against the live atko-cic/api2 schema and atko-cic/auth0-server code (not just the PRD). A few earlier concerns (SMS OTP length lower bound, TOTP-app digit count, a typo) are already fixed in this revision. Left inline comments on what's still open — mostly range/units accuracy and two documentation gaps for settings that are already live via the Management API but not yet documented here.

1. Navigate to [**Auth0 Dashboard > Security > Multi-Factor Auth**](https://manage.auth0.com/#/multifactor-auth) and select **Email**.
2. Configure the following:
- **Verification Code Length**: Enter a value between 4 and 10 digits.
- **Verification Code Lifetime**: Enter a value between 5 and 60 minutes.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Same issue as the range table above — "5 and 60 minutes" should be "0.5 and 60 minutes" if the true floor is 30 seconds, pending confirmation from eng on whether the Dashboard enforces a stricter minimum than the API.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Pending Engineering. Auth0 Dashboard is still showing 5 to 60 minutes.

5. Configure **Idle Trusted Browser Lifetime** in days or hours.
6. Configure **Maximum Trusted Browser Lifetime** in days or hours.
</Tab>
<Tab title="Auth0 Actions">

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

This section ("Change frequency of MFA prompts") only has Dashboard and Actions tabs. There's a real, GA Management API path for these same settings that isn't documented anywhere on this page:

  • GET/PUT /api/v2/guardian/settings (gated behind mfa_advanced_factor_config flag + update:tenant_settings scope)
  • Fields mfa_session_inactivity_timeout / mfa_session_overall_timeout (seconds), nested under universal_login.*
  • Confirmed the reader (auth0-server's buildTenantTimeoutConfig) and writer (this api2 endpoint) are aligned today — the field-mismatch bug between them was fixed by PR auth0-server#19166, merged 2026-08-12.

Suggest adding a third "Management API" tab here with GET/PUT + JSON examples, matching the pattern already used in the OTP-settings sections on the email/SMS pages, and noting the feature-flag/entitlement requirement.

Comment thread main/docs/secure/multi-factor-authentication/customize-mfa.mdx
Comment thread main/docs/secure/multi-factor-authentication/customize-mfa.mdx Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

DO NOT MERGE Only the PR author should merge, even if approved. main-docs Changes related to auth0's main docs (https://auth0.com/docs)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants