SfSkills Domains Docs GitHub

Home / security / mfa-enforcement-strategy

mfa-enforcement-strategy

Org-wide MFA rollout strategy, phased enablement, exception governance, and audit. Triggers: MFA rollout plan, MFA policy, MFA governance. NOT for per-user-type enforcement patterns — use security/mfa-enforcement-patterns.

Open the skill folder on GitHub


MFA Enforcement Strategy

Use this skill when you are defining how an organization turns on and sustains multi-factor authentication (MFA) for Salesforce human and non-human identities, not when you are wiring conditional challenges, IP-based login rules, or Flow-based login experiences. It focuses on org-wide enforcement posture, supported verification methods, Single Sign-On (SSO) delegation, exemptions, and the operational work that keeps logins working under pressure.


Before Starting

Gather this context before working on anything in this domain:


Questions to Ask Before Configuring

QuestionWhy it mattersWhat a good answer addsWhat proper configuration adds over just doing it
Which users can still log in with a Salesforce username and password, and which only through SSO?The Security Guide says the MFA requirement "applies equally to direct logins... and to logins via single sign-on." A parallel password path needs Salesforce-side MFA.A login-channel inventory per population.SSO-only populations can have Salesforce credentials disabled (isLoginWithSalesforceCredentialsDisabled).
How many in-scope users have no verification method registered today?TwoFactorMethodsInfo shows each user's registered methods (Salesforce Authenticator, TOTP, security key, built-in authenticator, temporary code).A measurable readiness number per phase.Enforcement starts when registration is high, not when the calendar says so.
Which verification methods will the org allow and support?enableBuiltInAuthenticator, enableU2F, enableLightningLogin, and allowUserAuthenticationByCertificate are separate org settings, and the help desk needs one recovery procedure per method.A short approved list with procurement for keys.Privileged users can be moved to stronger methods without a scramble.
Who holds "Waive Multi-Factor Authentication for Exempt Users", and why?The Summer '26 Metadata API guide says this permission overrides enableMFADirectUILoginOptIn. UNVERIFIED (2026-10-03): Salesforce Help says the 2026 enforcement removes that waiver behavior.A named, expiring list of exemptions.No surprise when the waiver stops working.
Which accounts are automation rather than people?Interactive MFA prompts break unattended jobs; integration users need OAuth-based patterns instead.A separate integration workstream with owners.Enforcement day does not stop data pipelines.
Do any profiles require a high-assurance session?ProfileSessionSetting.requiredSessionLevel HIGH_ASSURANCE means the session must have passed MFA.Step-up rules designed per profile.Sensitive profiles get MFA at every login even before org-wide enforcement.

Core Concepts

The 2026 enforcement events

UNVERIFIED (2026-10-03): the dates, populations, and quotes in this subsection come from Salesforce Help articles (listed in references/well-architected.md) that return only a script shell to an unauthenticated fetch; confirm them signed in before planning against them. The fetchable Security Guide (Summer '26) states only that Salesforce "requires MFA for logins to Salesforce products" and that the requirement "applies equally to direct logins with a Salesforce username and password and to logins via single sign-on (SSO)."

Salesforce is "enforcing Multi-Factor Authentication (MFA) for all employee logins, including direct UI and Single Sign-On (SSO), across both production and sandbox orgs." Two waves land on different dates, so a single "MFA deadline" on your program plan is already wrong:

EnforcementSandboxesProduction
MFA for all employee usersStarting June 22, 2026, staggered over approximately 7 daysStarting July 20, 2026, staggered over approximately 30 days
Phishing-resistant MFA (PRMFA) for privileged users, including adminsStarting June 22, 2026, staggered over approximately 7 daysStarting July 1, 2026, staggered over approximately 30 days

Two levers you may be relying on today disappear (UNVERIFIED (2026-10-03), Help only; the Summer '26 Metadata API guide still documents the waiver permission as overriding enableMFADirectUILoginOptIn): the org-wide MFA setting becomes active and admins "no longer have the ability to deselect or disable it," and the Waive Multi-Factor Authentication for Exempt Users permission "no longer automatically exempt[s] users from MFA"; holders are "prompted to enroll and use an MFA verifier at login." Rewrite any exemption-dependent runbook against the sandbox date, which arrives first and is where you will discover what breaks.

SSO does not clear the bar by itself. UNVERIFIED (2026-10-03), Help only: an SSO login satisfies enforcement only where the IdP passes a standard-MFA or phishing-resistant-MFA signal to Salesforce via ACR (Authentication Context Class Reference) or AMR (Authentication Methods Reference, RFC 8176). Where the IdP sends no such signal, those users are "required to enroll an MFA verifier in the Salesforce UI", so an IdP that enforces MFA but omits the claim still produces a visible change for every SSO user.

Phishing-resistant MFA and the permissions that trigger it

UNVERIFIED (2026-10-03), Help only: PRMFA applies to users with the System Administrator profile or any one of Modify All Data, View All Data, Customize Application, or Author Apex. Those four permissions travel on ordinary permission sets and permission set groups, so the PRMFA population is routinely far larger than the admin headcount. Enumerate it from effective permission assignments, never from the profile name alone.

Counts as phishing-resistantDoes not count
Built-in authenticators (Touch ID, Windows Hello)Salesforce Authenticator
Passkeys, device-bound, or cloud-synced through a password manager or keychain (1Password, Bitwarden, iCloud Keychain) provided that manager is FIDO2/WebAuthn-compliantMobile TOTP apps (for example, Google or Microsoft Authenticator)
External FIDO2/WebAuthn security keys (for example, YubiKey)
Certificate-based authentication using x.509 client certificates
Admin-generated temporary verification codes

Salesforce Authenticator and TOTP apps remain valid standard MFA. They simply do not satisfy the privileged-user requirement, which is the detail that strands admin populations who "already did MFA years ago."

Org-wide enforcement versus user self-registration

Salesforce distinguishes requiring MFA for direct logins to the Salesforce UI from users casually adding a verification method. Org-wide enforcement changes the login outcome for every in-scope user until they satisfy the requirement or a documented exemption applies. Treat enforcement as a program: communications, help desk readiness, backup codes or device replacement, and executive sponsorship matter as much as the toggle in Setup.

Supported verification methods (product surface)

The TwoFactorMethodsInfo object (Object Reference) records which methods each user has registered: HasSalesforceAuthenticator, HasTotp (authenticator apps that generate time-based one-time passwords), HasSecurityKey (WebAuthn-compatible keys), HasBuiltInAuthenticator (Touch ID, Windows Hello), HasU2F, and HasTempCode (an admin-generated temporary code). Org settings switch some methods on: enableBuiltInAuthenticator, enableU2F, enableLightningLogin, and allowUserAuthenticationByCertificate in sessionSettings. Pick a small approved set for the enterprise so help desk procedures stay consistent; avoid an unbounded list of consumer apps unless support teams are staffed for it. Querying TwoFactorMethodsInfo needs the "Manage MFA in API" permission.

SSO and MFA delegation

When users access Salesforce exclusively through SSO where the IdP enforces MFA, Salesforce can treat that path as satisfying the MFA expectation for those users (UNVERIFIED (2026-10-03): stated in Salesforce Help, not in the fetchable Security Guide, which says only that the requirement applies to SSO logins too), provided direct Salesforce login is not a realistic bypass (for example, broad password-based login still enabled for the same population). The failure mode is familiar: SSO is “MFA protected” but a subset of users retains a Salesforce password path and never registers a second factor with Salesforce. Validate both the IdP authentication policy and Salesforce login channels together.

Exemptions and integration identities

Some categories of users or flows may be excluded or handled differently under documented Salesforce exemption patterns (for example narrowly scoped automation or legacy constraints). Exemptions should be time-bound, approved, and rare, each one is debt that auditors and incident responders will ask about. Prefer modern patterns for integration users (OAuth flows designed for automation) over stretching human MFA policies across machine principals.


Common Patterns

Phased rollout by persona

When to use: Medium and large orgs where a single “big bang” cutover risks revenue or operations.

How it works: Pilot with IT and admins, then business units, then contractors. Run parallel reporting on who has not registered a verification method. Pair each phase with office hours and scripted recovery steps.

Why not the alternative: Flipping enforcement for everyone at once without inventorying SSO bypass and integrations produces preventable lockouts and emergency rollbacks.

SSO-first with Salesforce direct login disabled for employees

When to use: Enterprise standard is SAML or OpenID Connect from a central IdP with strong MFA at the IdP.

How it works: Align IdP MFA with corporate policy, remove or tightly control Salesforce direct login for employee populations, and validate break-glass admin paths.

Why not the alternative: Leaving parallel login paths defeats the economic and security rationale of central MFA and complicates attestation.

Verification method standardization plus security key program

When to use: High-assurance teams (finance, admins, developers with deployment rights).

How it works: Offer FIDO2 keys and documented provisioning; keep TOTP as fallback where keys are impractical.

Why not the alternative: Push-only reliance on a single mobile OS vendor stack can stall travelers or regulated sites where phones are restricted.


Decision Guidance

SituationRecommended ApproachReason
Majority on SSO with strong IdP MFADrive SSO-only access; eliminate unnecessary Salesforce passwordsCentralizes MFA evidence and reduces duplicate factors
Mixed SSO and Salesforce loginEnforce Salesforce MFA for password path; align IdP MFA for SSO pathCloses bypass where either path is realistic
Heavy API automationUse OAuth/JWT patterns appropriate to integration users; avoid treating API keys like human MFAKeeps automation reliable and auditable
User holds System Administrator, Modify All Data, View All Data, Customize Application, or Author ApexProvision a built-in authenticator, security key, or certificate-based auth before the PRMFA dateTOTP apps and Salesforce Authenticator do not satisfy the PRMFA requirement
Users who cannot use phonesStandardize on security keys or TOTP on corporate-managed devicesMaintains MFA without consumer phone dependency
Temporary vendor accessShort-lived accounts, clear offboarding, minimal exemptionsExemptions accumulate as shadow risk

  1. Inventory authentication paths: List IdP connections, remaining Salesforce-password users, Experience Cloud or external identity usage, and integration accounts.
  2. Read current org posture: Retrieve Settings:Security and ProfileSessionSetting, and note sessionSettings.enableMFADirectUILoginOptIn, the method switches (enableBuiltInAuthenticator, enableU2F, enableLightningLogin), singleSignOnSettings.isLoginWithSalesforceCredentialsDisabled, and any profile with requiredSessionLevel HIGH_ASSURANCE. Query TwoFactorMethodsInfo for registration coverage (SOQL in references/metadata-examples.md).
  3. Choose allowed verification methods: Publish the approved set, procurement for keys if needed, and help desk scripts for device loss.
  4. Close bypasses before enforcement: Address direct login, dormant passwords, and shared accounts that cannot complete MFA personally.
  5. Pilot and measure: Track registration completion, failed logins, and integration errors; adjust communications and training.
  6. Enable enforcement with rollback owners: Name who can act during an incident and rehearse break-glass; once the enforcement dates pass, rehearse verification-method recovery, because disabling the setting is no longer available.
  7. Run the local checker: From repo root: python3 skills/security/mfa-enforcement-strategy/scripts/check_mfa_enforcement_strategy.py --skip-skill --manifest-dir force-app to review retrieved Security.settings and ProfileSessionSetting files.

Review Checklist

Run through these before marking work in this area complete:


Salesforce-Specific Gotchas

Full write-ups with sources are in references/gotchas.md.

GotchaOne-line summary
Parallel password pathSSO MFA does not cover users who can still log in with a Salesforce password.
Integration identitiesInteractive MFA on automation accounts breaks jobs; redesign their auth instead.
Waiver permissionThe 262 Metadata API guide says the waiver overrides the org-wide opt-in; Help says 2026 enforcement ends that.
Transaction Security MFA actionNot available in Lightning Experience, the mobile app, or the API; it becomes a block.
Registration visibilityTwoFactorMethodsInfo needs "Manage MFA in API" and fails after uncommitted DML in the same call.
Trusted IP rangesThey skip device activation; they are not an MFA substitute.
Rollback after enforcementTurning the setting off stops being an option; recovery means verification-method help.

Output Artifacts

ArtifactDescription
MFA rollout runbookPhases, owners, communications, and rollback criteria
Exception registerEach exemption with business justification, approver, and review date
Authentication architecture noteSSO, direct login, and API flows in one diagram or table

Package files