[Access] Provide explicit guidance for how to require MFA on every login for Access applications - #32168
Conversation
Review
Fix in your agentFix the following review findings in PR #32168 (https://github.com/cloudflare/cloudflare-docs/pull/32168).
Before making changes, review each finding and present a brief summary table:
- For each finding, state whether you agree, disagree, or need clarification
- If you disagree (e.g. the fix requires disproportionate effort for minimal benefit,
or the finding is factually incorrect), explain why
- If you need clarification before deciding, ask those questions
- Then share your plan for which issues to tackle and in what order
After triaging, fix all legitimate findings. For any you decide to skip,
post a comment on this PR with the finding ID and your reasoning.
---
## Code Review
### Warnings (1)
#### CR-28598c20301a · Incomplete API request body
- **File:** `src/content/docs/cloudflare-one/access-controls/policies/mfa-requirements.mdx` line 154
- **Issue:** The new application-level API example only sets `mfa_disabled` and `session_duration` in `mfa_config`, omitting `allowed_authenticators`. The page describes Custom MFA settings as configuring both allowed authenticators and session duration, and the org-level API examples require the field.
- **Fix:** Add `allowed_authenticators` (e.g. `["totp", "biometrics", "security_key"]`) to the `mfa_config` example so it matches the dashboard flow and the rest of the docs.
Code ReviewThis code review is in beta and may not always be helpful — use your judgment. Warnings (1)
ConventionsNo convention issues found. Style Guide ReviewNo style-guide issues found. CommandsOnly codeowners can run commands. Post a comment with the command to trigger it.
|
|
This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:
|
b11eb55 to
500f6fe
Compare
…ccess applications
65dc0c6 to
7e5799f
Compare
|
just pushed update based on docs bot's suggestions |
|
Nimbus Preview URL: https://nimbus-7e5799ff.preview.developers.cloudflare.com |
|
Preview URL: https://7e5799ff.preview.developers.cloudflare.com Files with changes (up to 15) |
Summary
The MFA session duration section says you can "require users to complete MFA on each Access login" but never tells you how for non-SSH (web) applications. The only concrete instruction today is for SSH/infrastructure apps (0m for every SSH connection).
This adds a Require MFA on every login subsection under MFA session duration with:
session_duration: "0m"in themfa_configobjectFile changed:
src/content/docs/cloudflare-one/access-controls/policies/mfa-requirements.mdxScreenshots (optional)
N/A
Documentation checklist