Skip to main content

How to Disable Two-Factor Authentication for a Locked-Out WHM User

This guide explains how to disable Two-Factor Authentication (2FA) for a WHM user who has been locked out of their account due to a lost or inaccessible 2FA device. This process is performed by a Server Administrator within the WHM interface.

This guide explains how to disable Two-Factor Authentication (2FA) for a WHM user who has been locked out of their account due to a lost or inaccessible 2FA device. This process is performed by a Server Administrator within the WHM interface.

Before you begin

You will need:

  • Root access to the WHM interface.

  • The specific username of the account that requires the 2FA override.

Disable Two-Factor Authentication for a Locked-Out User

  1. Log in to WHM.

  2. Navigate to Security Center > Two-Factor Authentication.

  3. Locate the user account that is currently locked out.

  4. Select the checkbox next to that user's account.

  5. Click the Disable button (or the specific action to disable 2FA for the selected user).

Confirm the result

  • The user will no longer be prompted for a 2FA code when logging into WHM.

  • The status of the account in the Two-Factor Authentication interface will reflect that 2FA is disabled.

If the user still cannot log in

If the user is still unable to log in after 2FA is disabled, the issue may be related to an incorrect password or a locked IP address.

  • Verify the user's credentials.

  • Check the ConfigServer Security & Firewall (CSF) or cPHulk logs to see if the user's IP address is currently blocked.

Limitations

This procedure only disables the Two-Factor Authentication layer. It does not reset the user's password or clear IP blocks. If the user's password is incorrect, they must still perform a password reset.

Did this answer your question?