Cloudflare Docs
Cloudflare Fundamentals
Edit this page on GitHub
Set theme to dark (⇧+D)

Secure user access with two-factor authentication (2FA)

​​ Overview

Two-factor authentication (2FA) allows user account owners to add an additional layer of login security to Cloudflare accounts. This additional authentication step requires you to provide both something you know, such as a Cloudflare password, and something you have, such as an authentication code from a mobile device.

Cloudflare offers the option to use either a phishing-resistant security key, like a YubiKey, or a Time-Based One-Time password (TOTP) mobile app for authentication, like Google Authenticator, or both. If you add both of these authentication methods to your account, you are initially prompted to log in with the security key, but can opt-out and use TOTP instead.

To ensure that you can securely access your account even without your mobile device or security keys, Cloudflare also provides backup codes for download.

As the user account owner, you are automatically assigned the Super Administrator role. Once 2FA is enabled, all Cloudflare account members are required to configure 2FA on their mobile devices.


​​ Enable two-factor authentication for your Cloudflare account

We recommend that all Cloudflare user account holders enable two-factor authentication (2FA) to keep your accounts secure. 

2FA can only be enabled successfully on an account with a verified email address. If you do not verify your email address first, you may lock yourself out of your account.

To enable two-factor authentication for your Cloudflare login:

  1. Log in to the Cloudflare dashboard.
  2. Under the My Profile dropdown, select My Profile.
  3. Select Authentication
  4. Select Manage in the Two-Factor Authentication card.
  5. Configure either a TOTP mobile app or a security key to enable 2FA on your account.

​​ Configure security key authentication for two-factor Cloudflare login

A security key provides phishing-resistant multifactor authentication to your Cloudflare account using a built-in authenticator (Apple Touch ID, Android fingerprint, or Windows Hello) or an external hardware key (like YubiKey) that connects to your computer through USB-A, USB-C, NFC, or Bluetooth.

Cloudflare recommends configuring multiple security keys. With multiple keys, you can still use 2FA if the primary key is unavailable or if you are working on a different device.

After enabling 2FA on your Cloudflare account, you can select Manage to configure 2FA security key authentication.

​​ Configure a built-in authenticator (Apple Touch ID, Android fingerprint, or Windows Hello)

  1. In Security Key Authentication, select Add.
  2. On the Add a Security Key, enter your Cloudflare password and select Next.
  3. Interact with your built-in authenticator to add it to your Cloudflare account. 
  4. Enter a name for the built-in authenticator. If this is the initial setup, you will be prompted to generate backup codes. If not, skip to Step 8.
  5. Enter your Cloudflare password. 
  6. Select Next to review your backup codes. Backup codes can be used to access your user account without your mobile device.
  7. Select Download, Print, or Copy to save your backup codes in a secure location.
  8. Select Next to finish the configuration.

​​ Configure a security key (YubiKey)

Ensure that your hardware security key is configured and plugged in. On a Windows device, you may need to set up Windows Hello or register your security key to your Microsoft account. Review the Windows documentation for more details.

  1. Once your security key is plugged in, go to Security Key Authentication and select Add.
  2. Enter your Cloudflare password on the Add a Security Key screen, then select Next.
  3. Interact with your security key to add it to your Cloudflare account. Ensure that the dialog is for the security key setup. If the Windows Hello dialog appears on a Windows device, select Cancel. The security key dialog box will then appear. Depending on your system, you may be required to register a PIN for the security key.
  4. Enter a name for the security key. If this is the initial setup, you will be prompted to generate backup codes. If not, skip to Step 8.
  5. Enter your Cloudflare password. 
  6. Select Next to review your backup codes. Backup codes can be used to access your user account without your mobile device.
  7. Select Download, Print, or Copy to save your backup codes in a secure location.
  8. Select Next to finish the configuration. 

​​ Configure TOTP mobile application authentication for two-factor Cloudflare login

  1. Under Mobile App Authentication, select Add.
  2. Scan the QR code with your mobile device and enter the code from your authenticator application.
  3. Enter your Cloudflare password, then select Next. If you cannot scan the QR code, select Can’t scan QR code, Follow alternative steps to configure your authenticator application manually.

You can enable 2FA by scanning a QR code with your mobile device.
  1. Enter your Cloudflare password again.
  2. Select Next to review your backup codes. You can use backup codes to access your account without your mobile device.  
  3. Select DownloadPrint, or Copy to save your backup codes in a secure location.
  1. Select Next on the backup code page to complete the recovery code setup.

​​ Reconfigure TOTP mobile application authentication

You may need to reconfigure your mobile application authentication if you join a new organization or lose access to your mobile device. When you reconfigure your mobile application authentication, your previous TOTP codes are invalid.

To reconfigure, follow Steps 1-7 as detailed above.


​​ Regenerate backup codes

Each backup code is one-time use only, but you can always request a new set of backup codes using the Cloudflare dashboard. This is useful if you have lost access to or used all of your previous backup codes.

  1. Log in to the Cloudflare dashboard.
  2. Select My Profile.
  3. Select Authentication.
  4. Select Regenerate to generate and save a new set of two-factor backup codes.

​​ Disable two-factor authentication for your Cloudflare account

To disable 2FA for your Cloudflare account, you must delete all security keys and TOTP authenticators from your account.

  1. Log in to the Cloudflare dashboard

  2. Select My Profile.

  3. Select the Authentication.

  4. To remove your security key: 

    1. Select Edit in the Security Key Authentication card. A drop-down menu shows more details about your security key.
    2. Select Delete.
    3. Enter your Cloudflare password, then select Remove.
  5. To remove your TOTP mobile application authentication: 

    1. Select Delete method in the Mobile App Authentication card.
    2. Enter your Cloudflare password, authenticator application code, or a recovery code, then select Disable.

how to disable your TOTP mobile application authentication.


​​ Use a backup code

If you lose access to a mobile device, security key, or authentication code, you can solve these issues by using a backup code or retrieving a backup code from your preferred authentication app.

Refer to Google’s documentation to transfer Google Authenticator codes from one Android device to another.

When setting up 2FA, you should have saved your backup codes in a secure location. To restore lost access using a Cloudflare backup code:

  1. Retrieve the backup code from where you stored it.
  2. Go to the Cloudflare login page.
  3. Enter the backup code in the login screen, then select Log in.

​​ Recover your account

If you do not have access to your 2FA account or backup codes and cannot currently generate a 2FA code, use a verified device that you have logged in from before to request a temporary access code.

  1. Log into the Cloudflare dashboard.

  2. On the Two-Factor Authentication page, select Try recovery on Lost all 2FA devices and backup codes?.

  3. Select Begin recovery.

  4. A 6-digit access code will be sent to the email address associated with your Cloudflare account.

  5. Enter the temporary access code into the Cloudflare Dashboard and select Verify email.

  6. Select Verify device. This checks whether you are using a device that has previously logged into your account.

  7. If you receive a “Device verification failed” message:

    • If you clear your cookies often or are logging in from a different IP address, you have wiped Cloudflare’s memory of your device and will need to use a different device to verify.
    • For security reasons, you must wait three to five days after completing verification to receive your temporary access code.
    • Your browser may be set to clear cookies on exit or after browser or OS upgrades. This interferes with the device verification process.
    • You may be using anti-malware or other software that automatically clears your browser cookies and makes your device unregognizable by Cloudflare’s Dashboard.

If you are still unable to verify your device, contact Support.