Two-factor authentication for users

Use this page when you administer two-factor authentication (2FA) for other people: requiring it for one user, resetting it when someone loses their phone, and reading what each user's status means. The platform-wide mode is set in Sign-in security, and users manage their own setup on Two-factor authentication.

Read a user's 2FA status

Open Admin > Profile Management > Users. The 2FA column shows each user's state:

StatusWhat it means
OnThe user has set up 2FA and signs in with a code from their authenticator app.
Pending setup2FA is required for this user, but they have not set it up yet. They are asked to set it up the next time they sign in.
OffThe user has not set up 2FA, and none is required for them.

Require 2FA for one user

  1. Right-click the user's row and choose Require 2FA. On the user's page, hover over Two-factor authentication and choose Require 2FA.
  2. The product confirms with "Two-factor authentication is now required for this user".

Reset a user's 2FA

Reset 2FA when a user has lost their authenticator and cannot sign in with a code or a recovery code. The reset clears their setup, and they set it up again the next time they sign in.

  1. Open the user and choose Reset 2FA: hover over the Two-factor authentication row, pick it from the row menu, or click the Reset 2FA button in the 2FA column.
  2. In the Reset 2FA dialog, enter a Reason. It is required and can be up to 500 characters.
  3. Click Reset 2FA. The product confirms with "Two-factor authentication has been reset. The user must enroll again."

The dialog explains what the reset does before you confirm, and the confirm button stays off until the reason has text; an empty reason shows "Reason is required".

After a reset:

You cannot reset your own 2FA from here: the action is offered only for other users. Manage your own 2FA from your profile, as described in Two-factor authentication.

Note

A reset does not show you new recovery codes. The user receives a fresh set of 10 when they set 2FA up again.

Regenerate recovery codes

Recovery codes let a user sign in when their authenticator app is unavailable. Each user gets 10 codes when they set 2FA up, and each code works once. The codes are shown once, to the user, at setup and at each regeneration; nobody can read them later.

On your own account, a Regenerate action sits next to the Two-factor authentication row title. Hover over it to see how many codes you have left, then:

  1. Click Regenerate. The Regenerate recovery codes dialog opens.
  2. Enter the 6-digit code from your authenticator app. The dialog submits when the sixth digit is typed.
  3. Save the new codes when they appear. The product confirms with "New recovery codes generated. Your previous codes no longer work." The previous set stops working at once.

The same action is in your profile: see Two-factor authentication.

Permissions

What you want to doWhat you need
Require or remove 2FA for another userRequire 2FA For Others
Reset another user's 2FAReset 2FA For Others
Turn your own 2FA on or offRequire 2FA For Self, in the 2FA User and 2FA Manager bundles
Change the platform-wide modeManage Global 2FA, in Sign-in security

Actions you cannot perform are left out of the menus, and the platform checks the permission again when you act. See Roles and permissions for how roles work and the permission reference for the full list.

Limits and edge cases

Questions, answered

Why can't I see Require 2FA?

Require 2FA appears only while Global 2FA is Optional, and only if your role holds Require 2FA For Others. While the mode is Required, there is nothing to switch on. Check the mode in Sign-in security.

What does Pending setup mean?

2FA is required for the user, but they have not set it up yet. They are signed out and set it up the next time they sign in.

Can I require 2FA for my own account?

No. The action is refused with "You cannot require 2FA on your own account". Ask another administrator, or turn on 2FA for yourself from your profile, as described in Two-factor authentication.

Why is Reset 2FA missing for a user?

It appears only for other users who already have 2FA set up, and only if your role holds Reset 2FA For Others. It is never offered for your own account.

Does resetting 2FA sign the user out?

Yes. Every session the user has open ends, and they set 2FA up again at their next sign-in.

Do the user's recovery codes still work after a reset?

No. The reset clears the setup and the recovery codes together. The user receives a fresh set of 10 codes when they set 2FA up again.

The user ran out of recovery codes. What can they do?

They can regenerate new codes from the Recovery codes exhausted dialog with a code from their authenticator app, as described in Two-factor authentication. If they cannot use the app, reset their 2FA instead.

Why can't I remove a 2FA requirement?

While Global 2FA is Required, personal requirements cannot be removed: "2FA requirement cannot be removed while 2FA is required platform-wide." Set the mode back to Optional first, in Sign-in security.

Does the user get an email when I reset their 2FA?

Yes, if an Email channel is active. The email says an administrator reset their 2FA; they set it up again at their next sign-in. With no active Email channel, no email is sent.

Why is the 2FA column missing from the Users list?

It appears only while Global 2FA is on. With 2FA off platform-wide there is no status to show; the mode is set in Sign-in security.