Skip to content

joho1968/Cloudbridge-2FA

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Software License PHP 7.2+ PHP 7.4+ PHP 8.0+ PHP 8.1+ WordPress 5

Cloudbridge 2FA

Uncomplicated 2FA plugin for WordPress. Tested with WordPress 5.5+ and PHP 7.4+.

Description

Cloudbridge 2FA banner

This plugin provides uncomplicated 2FA plugin 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 will send a six-digit code via e-mail to the user attempting to log in. The code has a limited lifetime (defaults to 15 minutes). Once a code has been consumed, it is considered invalid.

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

You may also configure the plugin to allow certain roles to enable a 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.

Installation

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

Is the plugin locale aware

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.

Are there any incompatibilities

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

Changelog

1.0.0

  • Initial release

Screenshots

Cloudbridge 2FA login screen

Cloudbridge 2FA OTP code e-mail

License

Please see LICENSE for a full copy of GPLv2

Copyright (C) 2023 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.

Credits

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

Cloudbridge 2FA is sponsored by WebbPlatsen i Sverige AB, Sweden.

Commercial support and customizations for this plugin is available from WebbPlatsen i Sverige AB in Sweden.

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 [email protected].

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

More detailed documentation is available at code.webbplatsen.net/documentation/cb2fa

External references

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

Stay safe!