Uncomplicated 2FA for WordPress with e-mail OTP and authenticator app support.

This plugin provides uncomplicated 2FA functionality for WordPress. It will allow you to require a second, one time password or OTP, code to be entered when certain (or all) users attempt to log in to WordPress.

It supports two factor methods:

• six-digit codes sent by e-mail
• standards-based authenticator apps using TOTP

The e-mail code has a limited lifetime (defaults to 15 minutes). Once a code has been consumed, it is considered invalid.

Authenticator app setup is handled from the user's own profile page. The plugin provides a QR code, a manual setup key, and recovery codes for when the authenticator app is not available.

You may configure that only certain roles are required to use 2FA, and it is recommended that you enable 2FA for those users with privileged access.

You may also configure the plugin to allow certain roles to enable an OTP code bypass, which will set a cookie in that user's web browser. The cookies are partially based on the username, so several users can share the same browser, but still be required to always enter the OTP code, or bypass it if the cookie is present.

You can add custom text to the OTP code entry form, and you can add custom text to the OTP code e-mail message.

The plugin can be configured to allow it to be handled/managed only by specific users, thus making it harder for someone to accidentally or intentionally deactivate it. The implemented solution for this is by no means waterproof. If someone, for example, has access to your WordPress installation by means of FTP or similar, the plugin files can be physically removed (or moved out of your WordPress installation), which basically deactivates the plugin as well.

This section describes how to install the plugin and get it working.

1. Upload the contents of the cloudbridge-2fa folder to the /wp-content/plugins/ directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Configure the plugin settings

Cloudbridge 2FA uses standard WordPress functionality to handle localization/locale. The native language localization of the plugin is English. It has been translated to Swedish by the author.

This is a hard question to answer. There are no known incompatibilities.

• Fixed a settings-page regression where saving one tab could unset values on another tab
• Fixed the Bypass 2FA tab layout after the recent admin UI changes
• Restored returning to the active settings tab after saving
• Sent expired or stale login verification attempts back to the WordPress login screen so the user can start over cleanly

• Verified with PHP 7.4, 8.1, 8.2, 8.3, and 8.4
• Added authenticator app support using standards-based TOTP
• Added recovery codes for authenticator-enabled accounts
• Added QR code and manual setup key support to the user profile
• Reworked the admin settings so authenticator-app and e-mail OTP settings are easier to find
• Hardened redirect handling in login and OTP completion flows
• Added CSRF protection to configuration import

• Verified with WordPress 6.8 and 6.9

• Verified with WordPress 6.7
• Verified with Plugin Check (PCP)
• Corrected some checks for uninstall.php and made it more WP-CLI compatible

• Fix some incorrect links in plugin and README.md

• Fix of minor PHP warning

• Fix of minor PHP warning

• Initial release

Please see LICENSE for a full copy of GPLv2

Copyright (C) 2024-2026 Joaquim Homrighausen.

This file is part of Cloudbridge 2FA (CB2FA). Cloudbridge 2FA is free software.

You may redistribute it and/or modify it under the terms of the GNU General Public License version 2, as published by the Free Software Foundation.

Cloudbridge 2FA is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with the SCFA package. If not, write to:

The Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor
Boston, MA  02110-1301, USA.

The Cloudbridge 2FA Plugin was written by Joaquim Homrighausen while converting ☕ into code.

Cloudbridge 2FA is sponsored by WebbPlatsen i Sverige AB 🇸🇪

Commercial support and customizations for this plugin is available from WebbPlatsen i Sverige AB in 🇸🇪

If you find this plugin useful, the author is happy to receive a donation, good review, or just a kind word.

If there is something you feel to be missing from this plugin, or if you have found a problem with the code or a feature, please do not hesitate to reach out to support@webbplatsen.se.

This plugin can also be downloaded from code.webbplatsen.net and GitHub

More detailed documentation is available at code.webbplatsen.net/documentation/cloudbridge-2fa

These links are not here for any sort of endorsement or marketing, they're purely for informational purposes.

• me; 🐒 https://joho.se and https://github.com/joho1968
• WebbPlatsen; https://webbplatsen.se and https://code.webbplatsen.net
• Kudos to Kev Quirk for Simple CSS
• QR code setup on the authenticated profile page uses QR Code Generator for JavaScript by Kazuhiko Arase (MIT license)

Stay safe!