PluginProbe
Two Factor Authentication / 1.14.14
Two Factor Authentication v1.14.14
1.12.2 1.13.0 1.14.10 1.14.11 1.14.14 1.14.15 1.14.16 1.14.17 1.14.23 1.14.24 1.14.26 1.14.27 1.14.3 1.14.4 1.14.5 1.14.7 1.14.8 1.15.5 1.16.0 1.2.10 1.2.12 1.2.13 1.2.14 1.2.15 1.2.16 All 98 releases
two-factor-authentication / readme.txt

readme.txt in Two Factor Authentication 1.14.14, at readme.txt

817 lines 45.5 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
1 === Two Factor Authentication ===
2 Tags: two factor, 2fa, tfa, two factor auth, google authenticator
3 Requires at least: 3.4
4 Tested up to: 6.2
5 Stable tag: 1.14.14
6 Requires PHP: 5.6
7 Author: DavidAnderson
8 Contributors: DavidAnderson, DNutbourne
9 Donate link: https://david.dw-perspective.org.uk/donate
10 License: GPLv2 or later
11 License URI: https://www.gnu.org/licenses/gpl-2.0.html
12
13 Secure WordPress login with Two Factor Authentication - supports WP, Woo + other login forms, HOTP, TOTP (Google Authenticator, Authy, etc.)
14
15 == Description ==
16
17 Secure WordPress login with this two factor authentication (TFA / 2FA) plugin. Users for whom it is enabled will require a one-time code in order to log in. From the authors of <a href="https://updraftplus.com/">UpdraftPlus - WP's #1 backup/restore plugin</a>, with over two million active installs.
18
19 Are you completely new to TFA? <a href="https://wordpress.org/plugins/two-factor-authentication/faq/">If so, please see our FAQ</a>.
20
21 Features (please see the "Screenshots" for more information):
22
23 * Supports standard TOTP + HOTP protocols (and so supports Google Authenticator, Authy, and many others).
24 * Displays graphical QR codes for easy scanning into apps on your phone/tablet
25 * TFA can be made available on a per-role basis (e.g. available for admins, but not for subscribers)
26 * TFA can be turned on or off by each user
27 * TFA can be required for specified user levels, after a defined time period (e.g. require all admins to have TFA, once their accounts are a week old) (<a href="https://www.simbahosting.co.uk/s3/product/two-factor-authentication/">Premium version</a>), including forcing them to immediately set up (by redirecting them to the page to do so)
28 * Supports front-end editing of settings, via [twofactor_user_settings] shortcode (i.e. users don't need access to the WP dashboard). (The <a href="https://www.simbahosting.co.uk/s3/product/two-factor-authentication/">Premium version</a> allows custom designing of any layout you wish).
29 * Site owners can allow "trusted devices" on which TFA codes are only asked for a chosen number of days (instead of every login); e.g. 30 days (<a href="https://www.simbahosting.co.uk/s3/product/two-factor-authentication/">Premium version</a>)
30 * Works together with <a href="https://wordpress.org/plugins/theme-my-login/">"Theme My Login"</a> (both forms and widgets)
31 * Includes support for the WooCommerce and Affiliates-WP login forms
32 * Includes support for CozmosLabs Profile Builder
33 * Includes support for Elementor Pro login forms (Premium version)
34 * Includes support for bbPress login forms (Premium version)
35 * Includes support for login forms from the Gravity Forms User Registration add-on (Premium version)
36 * Includes support for any and every third-party login form (Premium version) without any further coding needed via appending your TFA code to the end of your password
37 * Does not mention or request second factor until the user has been identified as one with TFA enabled (i.e. nothing is shown to users who do not have it enabled)
38 * WP Multisite compatible (plugin should be network activated)
39 * Simplified user interface and code base for ease of use and performance
40 * Added a number of extra security checks to the original forked code
41 * Emergency codes for when you lose your phone/tablet (<a href="https://www.simbahosting.co.uk/s3/product/two-factor-authentication/">Premium version</a>)
42 * When using the front-end shortcode (<a href="https://www.simbahosting.co.uk/s3/product/two-factor-authentication/">Premium version</a>), require the user to enter the current TFA code correctly to be able to activate TFA
43 * Works together with <a href="https://wordpress.org/plugins/wp-members/">"WP Members"</a> (shortcode form)
44 * Administrators can access other users' codes, and turn them on/off when needed (<a href="https://www.simbahosting.co.uk/s3/product/two-factor-authentication/">Premium version</a>)
45
46 = Why use TFA / 2FA ? =
47
48 Read this! <a href="https://www.wired.com/2012/08/apple-amazon-mat-honan-hacking/">https://www.wired.com/2012/08/apple-amazon-mat-honan-hacking/</a>
49
50 = How Does TFA / 2FA Work? =
51
52 This plugin uses the industry standard TFA / 2FA algorithm [TOTP](https://en.wikipedia.org/wiki/Time-based_One-time_Password_Algorithm) or [HOTP](https://en.wikipedia.org/wiki/HMAC-based_One-time_Password_Algorithm) for creating One Time Passwords. These are used by Google Authenticator, Authy, and many other OTP applications that you can deploy on your phone etc.
53
54 A TOTP code is valid for a certain time. Whatever program you use (i.e. Google Authenticator, etc.) will show a different code every so often.
55
56 = Plugin Notes =
57
58 This plugin began life in early 2015 as a friendly fork and enhancement of <a href="https://wordpress.org/plugins/two-factor-auth/">Oscar Hane's "two factor auth" plugin</a>.
59
60 == Installation ==
61
62 This plugin requires PHP version 5.3 or higher and support for either php-openssl or [PHP mcrypt](http://www.php.net/manual/en/mcrypt.installation.php). The vast majority of PHP setups will have one of these. If not, ask your hosting company.
63
64 1. Search for 'Two Factor Authentication' in the 'Plugins' menu in WordPress.
65 2. Click the 'Install' button. (Make sure you picks the right one)
66 3. Activate the plugin through the 'Plugins' menu in WordPress
67 4. Find site-wide settings in Settings -> Two Factor Authentication ; find your own user settings in the top-level menu entry "Two Factor Auth".
68
69 If you want to add a section to the front-end of your site where users can configure their two-factor authentication settings, use this shortcode: [twofactor_user_settings]
70
71 == Frequently Asked Questions ==
72
73 = What is two factor authentication (TFA / 2FA) ? =
74
75 Basically, it's to do with securing your logins, so that there's more than one link in the chain needing to be broken before an unwanted intruder can get in your website.
76
77 By default, your WordPress accounts are protected by only one thing: your password. If that's broken, then everything's wide open.
78
79 "Two factor" means adding a second requirement. Usually, this is a code that comes to a device you own (e.g. phone, tablet) - so, someone can't get into your website without getting hold of your device. <a href="https://en.wikipedia.org/wiki/Two_factor_authentication">You can get a longer answer from Wikipedia.</a>
80
81 Sometimes it is also called multi-factor authentication instead of two-factor - because someone could secure their systems with as many factors as they like.
82
83 = Why should I care? =
84
85 Read this: <a href="https://www.wired.com/2012/08/apple-amazon-mat-honan-hacking/">https://www.wired.com/2012/08/apple-amazon-mat-honan-hacking/</a>
86
87 = How does two factor authentication (TFA / 2FA) work? =
88
89 Since "two factor authentication" just means "a second something is necessary to get in", this answer depends upon the particular set-up. In the most common case, a numeric code is shown on your phone, tablet or other device. This code be sent via an SMS; this then depends on the mobile phone network working. This plugin does not uses that method. Instead, it uses a standard mathematical algorithm to generate codes that are only valid once each, or for only for 30 seconds (depending on which algorithm you choose). Your phone or tablet can know the code after it has been set up once (often, by just scanning a bar-code off the screen).
90
91 = What do I need to set up on my phone/tablet (etc.) in order to generate the codes? =
92
93 This depends on your particular make of phone, and your preferences. Google have produced a popular app called "Google Authenticator", which is a preferred option for many people because it is easy to use and can be set up via just scanning a bar code off your screen - <a href="https://support.google.com/accounts/answer/1066447"> follow this link, and ignore the first paragraph that is talking about 2FA on your Google account</a> (rather than being relevant to this plugin).
94
95 = What if I do not have a phone or tablet? =
96
97 Many and various devices and programs can generate the codes. One option is an add-on for your web browser; for example, <a href="https://chrome.google.com/webstore/search/authenticator">here are some apps and add-ons for Google Chrome</a>. Wikipedia <a href="https://en.wikipedia.org/wiki/Time-based_One-time_Password_Algorithm#Client_implementations">lists various programs for different computers</a>.
98
99 = I lost my device that has pass-codes - or, they don't work. What to do? =
100
101 If your pass-code used to work, but no longer does, then check that the time on your device that generates them is accurate.
102
103 If you cannot get in and need to disable two-factor authentication, then add this to your wp-config.php file, using FTP or the file manager in your hosting control panel:
104
105 <code>define('TWO_FACTOR_DISABLE', true);</code>
106
107 Add it next to where any other line beginning with "define" is.
108
109 Alternatively, if you have FTP or cPanel access to your web hosting space, you can de-activate the plugin; <a href="https://updraftplus.com/understanding-wordpress-installs-plugins/">see this article.</a>
110
111 = Why does the plugin not support sending the two-factor code by email? =
112
113 If someone has access to your email account, then they can send a password-reset code there using the password-reset mechanisms built into WordPress. Therefore, if the two-factor code was also sent there, then ability to read your email allows the breaking of both factors, and hence is no longer truly *two* factor authentication.
114
115 Some users might have two factor authentication on their email account, but this is not knowable or controllable from inside WordPress, and so giving this option to users means that the administrator cannot see or enforce two-factor authentication. And even in this case, email is often sent between servers unencrypted, and so is susceptible to man-in-the-middle attacks beyond the control of WordPress.
116
117 = What are HOTP and TOTP? =
118
119 These are the names of the two mathematical algorithms that are used to create the special codes. These are industry-standard algorithms, devised by expert cryptographers. HOTP is less popular, but the device that generates the codes does not need to know the correct time (instead, the codes are generated in a precise sequence). TOTP is much more popular, and generates codes that are only valid for 30 seconds (and so your device needs to know the time). I'd recommend TOTP, as HOTP can be annoying if something causes the sequences to get out of sync.
120
121 = What is the shortcode to use for front-end settings? =
122
123 [twofactor_user_settings]
124
125 = I deliberately entered a wrong password, and it let me login! =
126
127 You have a password manager extension installed in your web browser, with the correct password entered in it. It has automatically replaced your wrong password with the right one from its saved store. This behaviour has been observed and confirmed by several users. You can verify it by using the web developer tools in your browser to look at the HTTP data sent to WordPress, and observe which password is actually in it. You can also open a fresh web browser with no such extension in it to re-test.
128
129 Note that the two factor authentication plugin has no mechanism to compare or approve passwords; this is done by WordPress core. If the wrong password is sent, then this is handled by WordPress, and the login will not proceed.
130
131 == Screenshots ==
132
133 1. Site-wide settings
134
135 2. User settings (dashboard)
136
137 3. User settings (front-end, via shortcode)
138
139 4. Regular WP login form requesting OTP code (after successful username/password entry)
140
141 5. WooCommerce login form requesting OTP code (after successful username/password entry)
142
143 6. What the user sees if opening a wrong OTP code on the regular WP login form
144
145 7. What the user sees if opening a wrong OTP code on the WooCommerce login form
146
147 8. Where to find the site-wide settings in the dashboard menu
148
149 9. Where to find the user's personal settings in the dashboard menu
150
151 10. Emergency codes (Premium version)
152
153 11. Adjusting other users' settings as an admin (Premium version)
154
155 12. Building your own design for the page with custom short-codes (Premium version)
156
157 13. Allowing users to have trusted devices (Premium version)
158
159 == Changelog ==
160
161 = 1.14.14 - 24/Mar/2023 =
162
163 * FIX: When on a multisite on a non-main site, the link shown to the network administration for the plugin was wrong
164 * TWEAK: Cache whether a user is using TFA when moving from the username field, in order to reduce delay when presenting TFA field
165 * TWEAK: Userlist related css file version to be based on its file's time.
166 * TWEAK: Add config utility methods and tweak registering settings.
167 * TWEAK: Add a span with CSS class simba_tfa_otp_login_help to the "check your OTP app to get this password" text
168 * TWEAK: Add support for CozmosLabs Profile Builder login forms
169 * TWEAK: Fix some minor problems related to translation domain handling and untranslatable phrases
170 * TWEAK: Suppress message that these are your personal settings for less-privileged users
171 * TWEAK: Ensure that user roles are translated
172 * TWEAK: Updated French translation, thanks to @madmax4ever
173
174 = 1.14.13 - 15/Nov/2022 =
175
176 * TWEAK: Improve styling of trusted device control when used with Gravity Forms User Registration Login forms
177
178 = 1.14.12 - 12/Nov/2022 =
179
180 * FEATURE: Add support (Premium version) for Gravity Forms User Registration Login forms
181 * TWEAK: Fix PHP notice with the AffiliateWP plugin if a user has not enabled TFA
182
183 = 1.14.11 - 25/Oct/2022 =
184
185 * TWEAK: Provide a link to the user's TFA settings on the user profile page
186 * TWEAK: Fix a typo (being/begin)
187 * TWEAK: In the admin settings, show more clearly in the "Make two factor authentication compulsory" section the dependence upon the earlier "Make two factor authentication" section
188
189 = 1.14.10 - 10/Oct/2022 =
190
191 * TWEAK: Only load Simba_TFA_Login_Form_Integrations class if not already present
192 * TWEAK: Hide all HTML entities that have `hide-when-displaying-tfa-input` class when 2FA code prompt at login time.
193
194 = 1.14.9 - 07/Oct/2022 =
195
196 * FEATURE: Allow the site owner to choose when policy enforcement (Premium) begins for already-existing users
197
198 = 1.14.8 - 05/Oct/2022 =
199
200 * TWEAK: Move JavaScript for displaying QR codes and handling trusted devices into its own file, for better CSP compatibility
201
202 = 1.14.7 - 28/Sep/2022 =
203
204 * TWEAK: Dynamic (non-explicitly declared) properties are deprecated as of PHP 8.2
205 * TWEAK: Update bundled Select2 4.0 version to current release
206 * TWEAK: Move JavaScript for administering other users into its own file, for better CSP compatibility
207 * TWEAK: When a device is already trusted, show this information as plain text, not in the TFA field
208 * TWEAK: When the TFA input field is shown, hide error messages from previous logins
209 * TWEAK: If the AJAX call to check on OTP status fails, show a user-visible message
210 * TWEAK: Add .localdomain hostnames to those permitted to have trusted devices
211 * TWEAK: Relabel "Get codes" button
212 * TWEAK: Add some filters allowing easier customisation of messages displayed
213 * TWEAK: Show only the base32 encoding of the private key (unless the shortcode explicitly specified otherwise), since for a long time now this is what all known apps accept
214
215 = 1.14.6 - 02/Sep/2022 =
216
217 * TWEAK: The TFA login script is loaded on the login script if a user has enabled the Two Factor Authentication feature.
218
219 = 1.14.5 - 01/Sep/2022 =
220
221 * TWEAK: Gave Premium mentions their own CSS class
222
223 = 1.14.4 - 15/Aug/2022 =
224
225 * FIX: Multisite Plugin Settings link to work in particular site plugins page for main site admin
226 * REFACTOR: Make the Simba Two Factor Authentication library more re-usable
227 * REFACTOR: Place premium auto-update code in the main file
228 * TWEAK: Introduce simba_tfa_get_option_site_id and simba_tfa_skip_adding_options_menu_entry filters
229
230 = 1.14.3 - 26/Jan/2022 =
231
232 * TWEAK: Change internal translation building and loading mechanism
233 * TWEAK: "https://" is not a translatable string
234 * TWEAK: Load translations even if aborting due to incompatible PHP version
235 * TWEAK: Update updater libraries to current versions
236
237 = 1.14.1 - 08/Nov/2021 =
238
239 * REFACTOR: The constants SIMBA_TFA_PLUGIN_DIR and SIMBA_TFA_PLUGIN_URL have been abolished. If you had hand-coded any code that used them, then you will want to review and test your customisations carefully first. This applies for all refactoring items and internal changes mentioned below.
240 * REFACTOR: Internal plugin directory structure changed
241 * TWEAK: Fix a potential PHP coding notice in 1.13.0 when an administrator viewed a user's QR code
242
243 = 1.13.0 - 01/Nov/2021 =
244
245 * REFACTOR: Complete re-organisation of all Premium code. If you had hand-coded any code which interacted with it, you will want to review and test your customisations carefully first. This applies for all refactoring items and internal changes mentioned below.
246 * REFACTOR: Abolished the class Simba_TFA_Plugin_Admin_Dashboard_Integration
247 * REFACTOR: Moved some TOTP/HOTP-specific methods out of Simba_Two_Factor_Authentication into Simba_TFA_Provider_TOTP
248 * TWEAK: Class TFA_Frontend renamed to Simba_TFA_Frontend
249 * TWEAK: The constant SIMBA_TFA_PLUGIN_FILE is no longer used internally and has been abolished
250 * TWEAK: Move Premium plugin update loader into the main Premium class
251 * TWEAK: Factor out all Premium features into individual classes
252 * TWEAK: The method tfa_is_available_and_active() has been removed.
253 * TWEAK: The method Simba_TFA_Provider_TOTP::getPanicCodesString() has been renamed to Simba_TFA_Provider_TOTP::get_emergency_codes_as_string()
254
255 = 1.12.3 - 22/Oct/2021 =
256
257 * FIX: Fix the twofactor_user_qrcode shortcode in the Premium version
258
259 = 1.12.2 - 21/Oct/2021 =
260
261 * FIX: Prevent load-order related fatal error (regression since 1.12.0) on sites that did not have AUTH_KEY defined in wp-config.php
262 * TWEAK: Update updater library in Premium version to latest version
263 * TWEAK: Introduce templating method for better code organisation
264
265 = 1.12.1 - 18/Oct/2021 =
266
267 * REFACTOR: Continuing the major re-factor of the plugin's internal classes. If you had hand-written custom PHP code that hooks into any internal classes, you will want to review your customisations carefully first.
268 * TWEAK: Update .pot file
269
270 = 1.12.0 - 16/Oct/2021 =
271
272 * REFACTOR: Major re-factor of the plugin's internal classes. If you had hand-written custom PHP code that hooks into any internal classes, you will want to review your customisations carefully first.
273 * TWEAK: Harmonise wording on trusted devices label
274 * TWEAK: Remove redundant hex2bin compatibility for no-longer-supported PHP versions
275
276 = 1.11.0 - 14/Sep/2021 =
277
278 * FEATURE: (Premium) Add new anti-bot feature for WooCommerce login forms: do not include the login form within the page HTML (making them invisible to most bots), bringing it back via JavaScript. The feature needs to be activated witin the plugin settings.
279
280 = 1.10.4 - 27/Jul/2021 =
281
282 * TWEAK: Fix a couple of minor visual regressions in the WooCommerce login form TFA field layout
283
284 = 1.10.3 - 28/Jun/2021 =
285
286 * FIX: Incorrect object reference in Affiliate WP integration (regression in 1.10.0)
287
288 = 1.10.2 - 26/Jun/2021 =
289
290 * TWEAK: The script tfa_frontend.php now uses an external JavaScript file (better compatibility with with content security policies)
291
292 = 1.10.1 - 25/Jun/2021 =
293
294 * FIX: Fix a bug in the Premium Elementor integration introduced in 1.10.0.
295
296 = 1.10.0 - 15/Jun/2021 =
297
298 * REFACTOR: Integrate the previously-separate WooCommerce/Affiliates-WP handlers in the main handler, eliminating redundant/duplicate code. Eliminate the internal concept of different form types by re-coding the few "type one"s as type twos. Separate login-form specific data from code.
299
300 = 1.9.6 - 04/Jun/2021 =
301
302 * FEATURE: Support bbPress login forms (Premium version)
303
304 = 1.9.5 - 26/May/2021 =
305
306 * TRANSLATIONS: Update bundled Spanish translation (es_ES) in Premium release
307
308 = 1.9.4 - 25/May/2021 =
309
310 * FIX: Prevent an issue identifying the username field when on a page with both Affiliates WP login and registration forms, when the login form displayed second
311
312 = 1.9.3 - 14/Apr/2021 =
313
314 * FIX: In the Premium version, when appending the TFA code to the password on third-party login forms with no direct support, only usernames were accepted for the login (not email addresses)
315
316 = 1.9.2 - 20/Mar/2021 =
317
318 * TWEAK: When checking if a user has TFA enabled on a login page, perform the same sanitisation on the username as WP core, so that if the user mis-types their username (which WP accepts) e.g. by prefixing a space, then they will still be asked for their TFA code (instead of jumping straight to an error for not supplying one)
319 * TRANSLATIONS: Added an Italian translation, thanks to Edoardo Di Leginio
320
321 = 1.9.1 - 15/Feb/2021 =
322
323 * TWEAK: Correct the "for" attribute of the "mark as trusted" text label on the WooCommerce login form
324
325 = 1.9.0 - 09/Feb/2021 =
326
327 * FEATURE: (Premium) If TFA is required for a user, and they have not yet set it up, then force them to be redirected to a configured URL
328 * TWEAK: Replace the deprecated jQuery.click() and .change() methods
329
330 = 1.8.8 - 16/Jan/2021 =
331
332 * TWEAK: Replace the deprecated jQuery.unbind() and .focus() methods
333 * TWEAK: If the free version is active, then throw an error if trying to activate the Premium version, explaining what needs to be done
334
335 = 1.8.7 - 11/Jan/2021 =
336
337 * TWEAK: Update jQuery document ready, click and submit styles to one not deprecated in jQuery 3.0, and replace :first pseudo-selector with .first()
338 * TWEAK: Now marked as supporting PHP 5.6+ (now that PHP 8.0 is out)
339 * TWEAK: Update to the latest version of the bundled updater library (paid versions), which adds integration with WP 5.5+'s auto-updater
340
341 = 1.8.6 - 15/Sep/2020 =
342
343 * FEATURE: Add a 'TFA' column also to the Users screen in the WP network admin dashboard (multisite installs)
344 * TWEAK: Update the bundled updater library (paid versions) to the current release
345
346 = 1.8.5 - 29/Aug/2020 =
347
348 * TWEAK: Fix the "for" attribute of the "trusted" text label on the WooCommerce login form
349 * TWEAK: If a website's wp-login.php is available under multiple hosts without CORS enabled between them, then AJAX calls would fail; this is now resolved by using a relative URL instead
350 * TWEAK: Update bundled updater libraries on Premium version (improving compatibility with WP 5.5+'s update settings)
351
352 = 1.8.4 - 26/May/2020 =
353
354 * TWEAK: Updare .pot file; now both the first two parameters to _n() are also included in the aggregation process
355
356 = 1.8.2 - 23/May/2020 =
357
358 * FIX: If the site owner was requiring a correct code to be supplied for activation, then this was also being required for de-activation
359 * TWEAK: Introduce simbatfa_enforce_require_after_check filter, allowing developers to selectively disable the "require TFA after X days" check
360 * TWEAK: Update .pot file
361
362 = 1.8.0 - 18/Apr/2020 =
363
364 * FEATURE: Add support in the paid version for Elementor login forms
365 * TWEAK: Updater in paid version now will make checks on availability without needing login
366 * TWEAK: Update updater class to current release
367
368 = 1.7.4 - 19/Mar/2020 =
369
370 * TWEAK: Adjust how the trusted field is referenced from JavaScript, fixing IE11 compatibility
371 * TWEAK: Introduce the filter simba_tfa_required_for_user
372
373 = 1.7.3 - 03/Mar/2020 =
374
375 * TWEAK: Provide non-plural alternative for trusted device phrase
376 * TWEAK: Mark as supporting WP 5.4
377
378 = 1.7.2 - 13/Feb/2020 =
379
380 * TWEAK: Update message about what to do with translations
381
382 = 1.7.1 - 14/Jan/2020 =
383
384 * FIX: Missing file in 1.7.0 (free) release
385
386 = 1.7.0 - 14/Jan/2020 =
387
388 * FEATURE: (Premium version): Add an optional TFA section to the WooCommerce account details section in "My Account"
389 * TWEAK: Fix div tag balancing issue in settings output
390 * TWEAK: Update WooCommerce integration to adjust to DOM changes in WooCommerce 3.8
391 * TWEAK: Update .pot file
392
393 = 1.6.4 - 12/Nov/2019 =
394
395 * TWEAK: On wp-login.php on WordPress 5.3, the password field was not hiding when the TFA field opened
396 * TWEAK: Update .pot file
397 * TWEAK: Add data-lpignore attribute to TFA field to indicate to LastPass that it is not a password field
398
399 = 1.6.3 - 18/Oct/2019 =
400
401 * FIX: The 'trusted users' option display in the settings defaulted to showing as enabled, whereas in fact the default setting is disabled
402 * TWEAK: Mark as compatible with WP 5.3
403
404 = 1.6.2 - 11/Sep/2019 =
405
406 * FIX: On multisites, administration of site users who were not present on the main site was not possible
407 * TWEAK: Introduce the WP action simba_tfa_activation_status_saved to allow developers to respond to activation status changes
408 * TWEAK: Update updater class to 1.8 series
409
410 = 1.6.1 - 10/Aug/2019 =
411
412 * TWEAK: Response to an attempt to turn TFA on can now include an "error" attribute if the attempt failed due to failure to supply the current code
413
414 = 1.6.0 - 08/Aug/2019 =
415
416 * FEATURE: (Premium version) By using the parameter style="require_current" with the shortcode twofactor_user_settings_enabled, the user will only be able to activate TFA if they enter the current TFA code
417 * TWEAK: Remove the incorrect suffix "(Premium)" (double-suffix in the actual Premium version) that appeared in the plugin title in 1.5.6
418
419 = 1.5.6 - 06/Aug/2019 =
420
421 * TWEAK: Allow customisation of a particular message via a filter simbatfa_message_you_should_verify
422 * TWEAK: Replace "eachother" with "each other"
423
424 = 1.5.5 - 30/Jul/2019 =
425
426 * TWEAK: Force a global context when creating the initial Simba_Two_Factor_Authentication object, to work around direct accesses from components that do not set the scope correctly
427
428 = 1.5.4 - 17/Jul/2019 =
429
430 * FEATURE: (Premium version) - allow the site administrator to forbid users who have compulsory TFA to turn it off (supplementing the additional capability to prevent them logging in)
431
432 = 1.5.3 - 22/Jun/2019 =
433
434 * TWEAK: When using your final emergency code (Premium version), and viewing your settings (which regenerated new ones), then if you did not follow the advice to reset your prviate key, you would get the same codes as before. This might be thought undesirable (though is not a security flaw, as the emergency codes are no more guessable the second time around than the first). This behaviour has now been changed.
435
436 = 1.5.2 - 08/Jun/2019 =
437
438 * TWEAK: When php-mcrypt was not installed, pressing the "Reset private key" link in a user's settings would cause an unnecessary PHP notice, and display a wrong "current code" for a few seconds.
439
440 = 1.5.1 - 05/May/2019 =
441
442 * FEATURE: Support any login form (Premium version) via appending the TFA code onto the end of the password. This allows support even of login forms coded in a way that make integrations (that aren't hacks or inordinate amounts of work-around code) impossible (e.g. PeepSo)
443 * TWEAK: Minor wording tweak in the explanation of how TOTP works.
444
445 = 1.4.12 - 18/Apr/2019 =
446
447 * TWEAK: Add a filter simba_tfa_localisation_strings allowing further customisation of front-end strings
448 * TWEAK: Add an extra instructional message in the "Make two factor authentication compulsory" section (Premium) to explain how to cope with existing users
449 * TWEAK: Cope with the user entering spaces in their two-factor code (TOTP protocol codes are numbers only, but some apps apparently display formatting and users are not aware)
450 * TWEAK: Mark as supporting WP 5.2
451
452 = 1.4.11 - 08/Mar/2019 =
453
454 * FIX: On multisites, the user search should search on all sites, not just the main one
455
456 = 1.4.10 - 01/Mar/2019 =
457
458 * TWEAK: Introduce a filter, simba_tfa_management_capability, allowing the WP capability (default: manage_options) required by a user to manage the plugin to be changed. (Be careful - giving the ability to manage could potentially mean the ability to lock any user out).
459
460 = 1.4.9 - 20/Feb/2019 =
461
462 * SECURITY: The security fix in version 1.4.7 was faulty and failed to completely fix the problem; it is now resolved in this release. Our apologies for the double update.
463
464 = 1.4.8 - 16/Feb/2019 =
465
466 * FIX: On some multisite setups, the link to the site-wide administration settings went to the wrong place
467
468 = 1.4.7 - 06/Feb/2019 =
469
470 * SECURITY: If a user's WordPress account username was in the form of an email address, and if their actual account email address was something different, and TFA was set up on that account, and used the "username" (that looked like an email address) to login, then TFA controls upon login on that account would be ineffective. Other accounts were not affected (regardless of whether you login by email or not). This vulnerability was inherited from the original "Two Factor Auth" plugin that this plugin was forked from, and so is present in all versions before this one.
471
472 = 1.4.6 - 05/Feb/2019 =
473
474 * FIX: When displaying a user's trusted devices in the admin page, the time that a device was trusted until was not shown correctly (instead, it showed the current time)
475 * FIX: Removing the first trusted device in a list did not always work
476 * TWEAK: Display "(none)" when there are no trusted devices
477
478 = 1.4.4 - 04/Feb/2019 =
479
480 * FEATURE: Trusted devices are now listed in the user's admin page, allowing them to see and remove trust from their devices.
481 * TWEAK: Updated .pot file
482
483 = 1.4.3 - 28/Jan/2019 =
484
485 * FIX: The "Trusted devices" functionality (Premium) checkbox was not appearing when activated
486 * TWEAK: Add a missing translation domain to a phrase
487
488 = 1.4.1 - 25/Jan/2019 =
489
490 * FEATURE: Trusted devices: A site owner can now choose to allow particular user levels (e.g. admins, editors) to mark devices as 'trusted' and thereby exempt from needing to enter a TFA code for a chosen number of days. This feature is off by default and requires https (i.e. SSL) on the login form and cookies to be kept in the trusted device.
491 * FIX: Fix a regression in 1.4.0 whereby when a site owner viewed another user's current code, it could later self-update with the wrong user's value
492 * TWEAK: Add the robustness in parsing broken JSON present on the standard WP login form to other login forms
493 * TWEAK: Various internal code documentation improvements
494 * TWEAK: Suppress mcrypt deprecation notices in places where we would use an alternative if it was not present
495 * TWEAK: Bumped the support requirement up to WP 3.4. I'm not aware of anything done to break it on 3.3, but this is the official requirement (it's very hard to test old WP versions as they don't run on modern webserver stacks)
496
497 = 1.4.0 - 24/Jan/2019 =
498
499 * FEATURE: Where the current OTP code is displayed (during setup), this will now self-update automatically (i.e. without needing a manual press on the "update" link).
500 * TWEAK: Various improvements to the layout and text of the setup page to help make the process more understandable
501 * TWEAK: The current code is shown next to the UI option for enabling TFA
502 * TWEAK: Prevent a PHP notice if AUTH_KEY was not defined (on some very old WP installs)
503
504 = 1.3.13 - 18/Dec/2018 =
505
506 * SECURITY: Fix a logged-in CSRF vulnerability reported by Martijn Korse (www.bitnesswise.com). Due to a missing nonce check, if an attacker was able to persuade a personally-targetted victim who was currently logged in to their WordPress account to visit a personally-crafted (for the individual victim) page in the same browser session, then the attacker would be able to de-activate two-factor authentication for the victim on that WordPress site (thus leaving the targetted account protected by the user's password, but not by a second factor - the absence of a request for a TFA code would be apparent on the user's next login). This vulnerability was inherited from the original "Two Factor Auth" plugin that this plugin was forked from, and so is present in all versions before this one.
507 * TWEAK: Some minor code-tidying
508 * TWEAK: Update bundled Premium updater library to current version (1.5.10)
509
510 = 1.3.12 - 14/Dec/2018 =
511
512 * TWEAK: Prevent a PHP debugging notice when $pagenow is not set
513
514 = 1.3.11 - 04/Dec/2018 =
515
516 * FEATURE: Add a 'TFA' column on the Users screen in the WP admin dashboard to display TFA status, thanks to Enrico Sorcinelli.
517
518 = 1.3.10 - 30/Nov/2018 =
519
520 * FIX: TFA codes were not being requested on the login form on a WooCommerce dedicated order payment page (i.e. /checkout/order-pay/123456/?pay_for_order=true&key=wc_order_blahblahblah) (meaning that if a user had TFA activated, login would fail).
521 * TWEAK: Prevent a PHP notice if AUTH_SALT was not defined (on some very old WP installs)
522
523 = 1.3.9 - 30/Oct/2018 =
524
525 * SECURITY: If you were not using the recommended option of requiring 2FA for XMLRPC requests, then an attacker could potentially also bypass requirements for 2FA on ordinary logins (i.e. only need the password). Such users will want to immediately update, though we recommend that all users do. This vulnerability was inherited from the original "Two Factor Auth" plugin that this plugin was forked from, and so is present in all versions before this one.
526
527 = 1.3.8 - 25/Oct/2018 =
528
529 * TWEAK: Update the updater class in the Premium version to the current release (1.5.6)
530
531 = 1.3.7 - 15/Oct/2018 =
532
533 * TWEAK: Try to mitigate plugins on the login page which cause JavaScript exceptions by enqueing our scripts earlier.
534
535 = 1.3.6 - 04/Oct/2018 =
536
537 * TWEAK: Add attribute autocomplete="off" on the WooCommerce login form TFA field (was already present for regular WP login form)
538 * TRANSLATION: Added Portuguese (Brazilian) translation, courtesy of Dino Marchiori
539
540 = 1.3.5 - 02/Oct/2018 =
541
542 * TWEAK: Some code-styling consistency clean-ups
543 * TWEAK: Allow one more window's tolerance by default for codes from devices running fast
544
545 = 1.3.4 - 11/Sep/2018 =
546
547 * FIX: Sometimes a TML widget login form could fail to work because of a changed/unexpected DOM tree
548 * FIX: Some further breakage in TML had occurred, causing login buttons to require to be pressed twice
549
550 = 1.3.3 - 31/Jul/2018 =
551
552 * FIX: Restore support for "Theme My Login", which had been broken by unannounced changes in TML 7.x
553 * TRANSLATIONS: Update .pot file
554
555 = 1.3.2 - 31/May/2018 =
556
557 * TWEAK: Add the simbatfa_check_tfa_requirements_ajax_response and simbatfa_verify_code_and_user_result filters to allow over-riding of the response to the "TFA required?" question and the TFA check itself by developers
558
559 = 1.3.1 - 25/May/2018 =
560
561 * FIX: The WooCommerce 3.3+ login form was requiring two clicks on the 'Log In' button
562 * TWEAK: The progress spinner had disappeared on WooCommerce 3.3+
563
564 = 1.3.0 - 05/Apr/2018 =
565
566 * FEATURE: (Premium version) Integration with the WP-Members login form, https://wordpress.org/plugins/wp-members/ . N.B. WP-Members does not pass on the real error message upon a login failure, but displays its own hard-coded message that the username/password were wrong; so you'll see this even if it was really the TFA code that was wrong.
567 * TWEAK: Change the permission check for editing other users (Premium version) to edit_users (instead of the previous update_plugins, intended just as a proxy for "is an admin")
568 * TWEAK: Stop using the deprecated jQuery.parseJSON method
569 * TWEAK: Change a string that was not in a translatable form
570 * TWEAK: Update the updater class in the Premium version to the current release (1.5.1)
571
572 = 1.2.35 - 28/Nov/2017 =
573
574 * TWEAK: Upon front-end settings save, do jQuery(document).trigger('tfa_settings_saved'), allowing the user to respond to the action (e.g. reload page)
575 * TWEAK: Suppress mcrypt deprecation notices on PHP 7.1 (we already know it is deprecated, and already use openssl if it is not installed)
576
577 = 1.2.34 - 08/Nov/2017 =
578
579 * TWEAK: Remove calls to the deprecated screen_icon() function
580 * TWEAK: Remove some unnecessary bundled translation files
581 * TWEAK: Add some translation files not previously included in the Premium version
582 * TWEAK: Update bundled Premium updater library to current (1.5.0)
583
584 = 1.2.33 - 09/Oct/2017 =
585
586 * FIX: The available/required settings for super-admins on multisite installs were not saving (Premium feature)
587 * FIX: When the admin fetched another user's current QR code, it embedded the wrong username (which was a cosmetic issue only - the code itself was correct) (Premium feature)
588
589 = 1.2.32 - 06/Oct/2017 =
590
591 * TWEAK: Update bundled updater in Premium to latest version (1.4.8)
592
593 = 1.2.31 - 05/Oct/2017 =
594
595 * FEATURE: (Relevant to Premium version): Automatically generate new emergency codes when they run out, including upon view of settings if there are none (e.g. on upgrade from free to Premium)
596 * TWEAK: Code-styling consistency tweaks
597
598 = 1.2.30 - 18/Sep/2017 =
599
600 * FIX: TML shortcode forms were not working properly for non-TFA users
601
602 = 1.2.29 - 16/Sep/2017 =
603
604 * FIX: Prevent double-show of TFA field on TML default login page (regression)
605 * FIX: Restore functionality on TML shortcode forms (regression, likely due to changes in TML)
606 * TWEAK: Restore the spinner to proper size on all forms
607 * TWEAK: A few very minor code style clean-ups
608
609 = 1.2.27 - 29/Aug/2017 =
610
611 * TWEAK: Add the new 'PHP Requires' header to readme.txt
612 * TWEAK: Correct a couple of wrong translation domain references
613
614 = 1.2.26 - 08/Aug/2017 =
615
616 * FIX: Do not request TFA code on TML reset password form (regression, likely due to changes in TML)
617 * APOLOGIES: 1.2.25 was a faulty release that would block logins. You should immediately update.
618
619 = 1.2.24 - 05/Aug/2017 =
620
621 * TWEAK: Update to the latest version of the updater library (Premium)
622
623 = 1.2.23 - 15/Jun/2017 =
624
625 * TWEAK: Allow admins to reset users' private keys (Premium)
626
627 = 1.2.22 - 23/May/2017 =
628
629 * TWEAK: Update updater library to current version (Premium)
630 * TWEAK: Use higher-quality spinner image
631 * COMPATIBILITY: Mark as compatible with WP 4.8
632
633 = 1.2.21 - 22/Feb/2017 =
634
635 * TWEAK: Update jquery-qrcode library to latest release (0.14.0)
636 * TWEAK: Explicitly encode spaces in WordPress usernames (apparently resolves a problem with a particular iPhone app)
637
638 = 1.2.20 - 17/Feb/2017 =
639
640 * TWEAK: Work around a bug seen with strlen() on one particular PHP install
641 * FIX: The line purporting to show the current UTC time was in fact taking your WordPress timezone into account. It has now been adjusted to show both to avoid ambiguity.
642 * FIX: 1.2.18 used a PHP 5.4+ only function, whereas we support PHP 5.3+
643
644 = 1.2.17 - 09/Feb/2017 =
645
646 * FIX: Fix support for login widgets from Theme My Login
647
648 = 1.2.16 - 30/Jan/2016 =
649
650 * FIX: Fix issue whereby if you were already logged in and managed to visit a login form, you would not be asked for a TFA code
651
652 = 1.2.15 - 23/Jan/2017 =
653
654 * FEATURE: Add support for login widgets from Theme My Login
655 * UPDATER: (Premium version): update to the latest updater class, including the new ability to automatically update
656
657 = 1.2.14 - 02/Jan/2017 =
658
659 * TWEAK: Add missing internationalisation headers to the main plugin file
660
661 = 1.2.13 - 31/Aug/2016 =
662
663 * TWEAK: Internationalisation implementation was not previously compatible with wordpress.org's translation system
664
665 = 1.2.12 - 20/May/2016 =
666
667 * FEATURE: Compatibility with https://wordpress.org/plugins/use-administrator-password/ - when TFA is enabled on an account, the TFA credentials of the user whose password was supplied are allowed (and required)
668
669 = 1.2.11 - 18/May/2016 =
670
671 * TWEAK: Update bundled select2 to version 4.0.2
672 * FIX: If the [twofactor_user_qrcode] shortcode (Premium version) was used without other short-codes, then the code would not display
673
674 = 1.2.10 - 31/Mar/2016 =
675
676 * TWEAK: Prefer openssl, if present, to the deprecated mcrypt. Note that if you migrate a site from a server without openssl to a server without mcrypt, then because of mcrypt's non-compliant padding, you will need to either install php-mcrypt on the new server, or disable TFA (via define('TWO_FACTOR_DISABLE', true); in your wp-config.php) to allow users to be able to log in. This also applies if the source site did have openssl, but for users who hadn't logged in since installing this update.
677 * TWEAK: Make the $simba_two_factor_authentication_premium object globally available
678 * COMPATIBILITY: Mark as tested on WP 4.5
679
680 = 1.2.8 - 12/Dec/2015 =
681
682 * FEATURE: Add support for the Affiliates-WP login form
683 * TWEAK: Defeat WooCommerce loading an old version of the select2 script onto the TFA settings page, and breaking the user selector (should work this time)
684
685 = 1.2.6 - 11/Nov/2015 =
686
687 * TWEAK: Defeat WooCommerce loading an old version of the select2 script onto the TFA settings page, and breaking the user selector
688 * TWEAK: Tested on WordPress 4.4
689 * TWEAK: Use h1 for heading style on admin page, not h2
690 * FIX: The "You'll need to use TFA to login in future" link for users for whom TFA is compulsory (Premium) was to the wrong page
691
692 = 1.2.4 - 09/Nov/2015 =
693
694 * TWEAK: Make window settings filterable
695
696 = 1.2.3 - 19/Oct/2015 =
697
698 * FIX: Fix bug in 1.2.2 that could lock out users without TFA settings
699
700 = 1.2.2 - 16/Oct/2015 =
701
702 * TWEAK: Display dashboard notice if TWO_FACTOR_DISABLE is defined in wp-config.php, to prevent time wasted wondering why nothing is happening
703
704 = 1.2.1 - 08/Oct/2015 =
705
706 * FEATURE: (Premium version) - Require users (of configured roles) to use TFA (optionally after a configurable amount of time)
707
708 = 1.1.21 - 25/Aug/2015 =
709
710 * TRANSLATIONS: Translation files can now be used (translators welcome!)
711 * TRANSLATION: Swedish translation added, courtesy of Bo Sving
712
713 = 1.1.19 - 20/Aug/2015 =
714
715 * TWEAK: Remove a pointless nonce check
716
717 = 1.1.18 - 01/Aug/2015 =
718
719 * COMPATIBILITY: Tested with WP 4.3 (RC1) and WooCommerce 2.4 (RC1) - no issues found (i.e. previous releases believed to be already compatible)
720 * FIX: When the admin is showing codes for other users, QR codes were not displaying correctly since 1.1.13
721
722 = 1.1.17 - 22/May/2015 =
723
724 * TWEAK: Introduce convenience method for developers wanting to verify that TFA is active (Premium)
725 * FIX: Fix operation of [twofactor_conditional] shortcode (Premium)
726 * FIX: Fix fatal error introduced in convenience method in 1.1.16
727
728 = 1.1.15 - 13/May/2015 =
729
730 * FIX: Fix conflict with 'reset password' form with "Theme My Login" plugin
731
732 = 1.1.14 - 12/May/2015 =
733
734 * FIX: Add TFA support to the WooCommerce login-on-checkout form (previously, TFA-enabled users could not log in using it)
735
736 = 1.1.13 - 11/May/2015 =
737
738 * TWEAK: Use jquery-qrcode to generate QR codes, replacing external dependency on Google
739 * TWEAK: Update bundled select2 library to 4.0.0 release (was rc2)
740
741 = 1.1.12 - 22/Apr/2015 =
742
743 * FIX: Fix corner-case where the user's login looked like an email address, but wasn't the account address. In this case, a OTP password was always requested.
744 * FIX: When the username does not exist, front-end should not request TFA code.
745
746 = 1.1.11 - 21/Apr/2015 =
747
748 * TWEAK: Prevent PHP notice if combining with bbPress
749 * TWEAK: Added more console logging if TFA AJAX request fails
750 * TWEAK: Add some measures to overcome extraneous PHP output breaking the AJAX conversation (e.g. when using strict debugging)
751
752 = 1.1.10 - 20/Apr/2015 =
753
754 * SECURITY: Fix possible non-persistent XSS issue in admin area (https://blog.sucuri.net/2015/04/security-advisory-xss-vulnerability-affecting-multiple-wordpress-plugins.html)
755 * FIX: Don't get involved on "lost password" forms (intermittent issue with "Theme My Login")
756
757 = 1.1.9 - 15/Apr/2015 =
758
759 * TESTING: Tested with "Theme My Login" - http://wordpress.org/plugins/theme-my-login/ - no issues
760 * TWEAK: Do a little bit of status logging to the browser's developer console on login forms, to help debugging any issues
761 * TWEAK: Add a spinner on login forms whilst TFA status is being checked (WP 3.8+)
762 * TWEAK: Make sure that scripts are versionned, to prevent updates not being immediately effective
763 * TWEAK: Make sure OTP field on WooCommerce login form receives focus automatically
764
765 = 1.1.8 - 14/Apr/2015 =
766
767 * FIX: Fix an issue on sites that forced SSL access to admin area, but not to front-end, whereby AJAX functions could fail (e.g. showing latest code)
768 * FIX: Version number was not shown correctly in admin screen since 1.1.5
769 * TWEAK: Show proper plugin URI
770
771 = 1.1.7 - 10/Apr/2015 =
772
773 * FIX: Fix plugin compatibility with PHP 5.6
774 * FIX: TFA was always made active on XMLRPC, even when the user turned it off
775
776 = 1.1.6 - 09/Apr/2015 =
777
778 * TWEAK: Change various wordings to make things clearer for new-comers to two-factor authentication.
779
780 = 1.1.5 - 07/Apr/2015 =
781
782 * FEATURE: Admin users (Premium version) can show codes belonging to other users, and activate or de-activate TFA for other users.
783 * PREMIUM: Premium version has now been released: https://www.simbahosting.co.uk/s3/product/two-factor-authentication/. Features emergency codes, personal support, and more short-codes allowing you to custom-design your own front-end page for users.
784 * TWEAK: Premium version now contains support link to the proper place (not to wordpress.org's free forum)
785 * TWEAK: Added a constant, TWO_FACTOR_DISABLE. Define this in your wp-config.php to disable all TFA requirements.
786 * FIX: Fix a bug introduced in version 1.1.2 that could prevent logins on SSL-enabled sites on the WooCommerce form when not accessed over SSL
787
788 = 1.1.3 - 04/Apr/2015 =
789
790 * TWEAK: Provide "Settings saved" notice when user's settings are saved in the admin area (otherwise the user may be wondering).
791
792 = 1.1.2 - 03/Apr/2015 =
793
794 * FIX: Include blockUI JavaScript (the lack of which caused front-end options not to save if you did not have WooCommerce or another plugin that already used blockUI installed)
795 * FEATURE: Don't show anything on the WooCommerce login form unless user is using 2FA (i.e. behave like WP login form)
796 * FEATURE: Added 9 new shortcodes for custom-designed front-end screens (Premium - forthcoming)
797
798 = 1.1.1 - 30/Mar/2015 =
799
800 * Support added for multisite installs. (Plugin should be network-activated).
801 * Support added for super-admin role (it's not a normal WP role internally, so needs custom handling)
802 * Tested + compatible on upcoming WP 4.2 (tested on Beta 3)
803 * Re-add option to require 2FA over XMLRPC (without specific code, XMLRPC clients don't/can't use 2FA - but requiring it effectively blocks hackers who want to crack your password by using this weakness in XMLRPC)
804
805 = 1.0 - 20/Mar/2015 =
806
807 * First version, forked from Oskar Hane's https://wordpress.org/plugins/two-factor-auth/
808 * Support for email "two-factor" removed (email isn't really a second factor, unless you have multiple email accounts and guard where your "lost login" emails go to)
809 * WooCommerce support added to the main plugin. Load WooCommerce JavaScript only on pages where it is needed.
810 * Use AJAX to refresh current code (rather than reloading the whole page)
811 * Added WordPress nonces and user permission checks in relevant places
812 * Shortcode twofactor_user_settings added, for front-end settings
813 * User interface simplified/de-cluttered
814
815 == Upgrade Notice ==
816 * 1.14.14 : Various tweaks/small improvements and a multisite fix. A recommended update for all.
817