XF 1.5 Two-Step Verification and Security Improvements

Account security has become a hot topic recently. There are seemingly endless stories about password databases from popular sites being leaked. Because password reuse is common, we've started to see brute force login attempts using these leaked passwords. Maintaining account security has become a big priority. To help this, we've added a few new features.

Two-Step Verification

Two-step verification, also known as two-factor authentication, requires you to provide two pieces of information to login. The general form is expressed as "something you know and something you have". "Something you know" is your password. "Something you have" is the new part. You may have seen this with other services, such as Google accounts. If you're familiar with that, you'll understand how it works in XenForo.

Two-step verification is something a user has to opt into sometime after they have registered. Enabling it increases security at the expense of a more complex login procedure. For many users--particularly ones that just lurk or only have a few posts--the "value" of their account is low so the cost may outweigh the benefit. However, for privileged users, the extra security should be worthwhile.

When you've enabled two-step verification, you will login with your username or email and password as normal. Once those are verified, we will determine if two step verification is needed. If so, you'll need to take the appropriate steps to complete that. Upon receiving that verification, you'll be logged in as normal.

Let's look at how each step works in more detail...

Two-Step Verification: Setup

two-step-setup1.webp
two-step-setup2.webp


To enable, you enter the two-step verification page from the account section. Note that you'll need to confirm your password before you can do any manipulation to the two-step verification settings.

To enable, you simply pick the method of verification you want to use. XenForo ships with two "primary" verification methods:
  • Verification code via app - this will use an app on your phone (such as Google Authenticator or Authy) to generate a 6 digit code. This code changes every 30 seconds.
  • Email confirmation - this will send a unique, one-time-use code to the email address associated with your account. This method is not preferred over the app-based verification because if an attacker has access to your account, they may also have access to your email. However, it's certainly better than nothing.
To enable any method, you will need to go through the verification process to ensure that everything works as expected. This prevents you from being locked out by a system you didn't successfully complete once.

You can enable multiple two-step verification methods.

The two-step verification "provider" system can be extended by third-party developers to add different methods (for example, YubiKey support, phone/text-based verification, etc).

There is also a third method that is automatically enabled when the first two-step verification provider is enabled: backup codes. These are designed to be saved for emergencies when you can't verify your login through any other method (if you don't have your phone, for example). Each backup code can be used once and you will be sent an email whenever a backup code has been used.

Two-Step Verification: Login

If you have enabled two-step verification, this covers logging in via the admin control panel and the public-facing login.

two-step-login.webp


After verifying your password, if two-step verification is required, you'll be taken to a page such as the one shown above. By default, the highest priority, currently enabled two-step verification method will be triggered. (The priority is set by the developer.) If you wish to use an alternative method, you can choose to do so for this login.

This also gives you the option to trust this device for 30 days. You may be familiar with this approach with other two-step verification systems. If you trust this device, you can log out and log in without being prompted to complete two-step verification for 30 days. This helps to mitigate the annoyance that two-step verification can create.

Once the 30 days are up, you will be prompted to complete the two-step verification again (even if you have chosen to stay logged in).

In the event that you want to stop trusting a device or you need to revoke that trust for other devices, you can do this from the two-step verification setup page in the account system:

two-step-trust.webp


Two-Step Verification: Losing Access

A common concern with two-step verification is what happens if you lose access to all of your two-step verification methods. We have attempted to mitigate that as much as possible.
  • Backup codes are really generated for this exact situation. If you lose your phone or your email is no longer valid, the backup codes will still work. However, this does require saving them once they're generated. This is something that not all users will do.
  • Disabling two-step verification only requires access to the password when you're already logged in. If users choose to trust a device, this very likely means that they will still have access to their account. Once they verify their password, they'll be able to change their two-step verification settings as necessary.
  • Finally, admins can see the current two-step verification status and disable it if necessary:
    two-step-admin.webp


Password and Email Change Notifications

Beyond two-step verification, we have also made several other small account security-related improvements.

Now, if your password is changed, you will receive an email to make you aware of this. Normally you can disregard this, but it serves to help notify you if someone is accessing your account and attempting to block your access to it.

Similarly, if your registered email is changed, you'll receive an email (to the previous address) to make you aware of this.



Password Reset Process Changed

The password reset process has been simplified to be more user friendly and not send a password via email. Once you receive the email for the password reset request, the link will allow you to set a new password directly. This is more in line with current approaches to password resetting.



That's all for today, but there's still more up our sleeves...

Just a reminder: Please do not post suggestions in this thread (even if you feel they are related). Use the dedicated suggestion forum so they can be tracked.
 
I am local, I often disconnects, and each connection, verification is requested, it's painful to strength ..

Even with permission to "No".

Same problem to enter the admincp (Option unchecked: Screenshot)
 
If you no longer wish to use 2FA then just disable it in Account > Two Step Verification.

The setting in your screenshot forces users of the Admin CP to set up 2FA if it is not currently enabled.

If you wish to keep 2FA enabled, but you don't wish to be prompted every time you log on, you need to "Trust this device for 30 days".

It's possible to disable as "$config['enableListeners'] = false;" but for Two-Step Verification?
Yes, there is something similar - it should only be used to allow you to disable 2FA if you are somehow locked out, though. "$config['enableTfa'] = false;"

Finally, just to note, if you have any further questions or problems, please start a new thread in the appropriate forum. This thread shouldn't be used for support.
 
There is no option to disable it.

It's entirely optional for members.

Is there a way to disable it for admins? I work a lot in several browsers when working on mods and it asks me even though I have nrequested authentication for 30 days. BTW, you are the most helpful Mod on the XF forums!
 
All administrators MUST enable two-step verification? Isnt there a way to disable this function in the system altogether, for everyone?

BTW, this is also forcing me to authenticate with an email code even when just accessing the forums. Traffic has dropped to ZERO for my site since this thing was put in place by my upgrade.
 
2FA is only required if the option is explicitly enabled (you said it wasn't) or the permission to require it has been explicitly enabled. Use analyze permissions to check this. Beyond that, it won't be involved unless you (as a user) follow the steps to actually enable it.

If you have any further issues or questions, please post a dedicated support thread.
 
2FA is only required if the option is explicitly enabled (you said it wasn't) or the permission to require it has been explicitly enabled. Use analyze permissions to check this. Beyond that, it won't be involved unless you (as a user) follow the steps to actually enable it.

If you have any further issues or questions, please post a dedicated support thread.

Which forum would I do that in? I just searched for an existing one. Sorry to be such a noob! I just checked the User and Usergroup permissions on myself (I am the Super Admin), and I do not see anything for 2FA. I see the box for admin access, and that is unticked. Also, I see the link in my profile to disable it. The problem is that when I disable it, the very next page tells me that I have to re-enable it. I re-enable it, then get the email to remember the device for 30 days, but it asks me every time even when just accessing the forums. It asks if I use Chrome, after authenticating in Firefox. I have no idea what my users are experiencing because my site traffic has dropped off. If they are all getting this 2FA thing, I am doomed. I want to know if there is a way to disable it. I can start a new thread, I just do not know where to start it.
 
Which forum would I do that in? I just searched for an existing one. Sorry to be such a noob! I just checked the User and Usergroup permissions on myself (I am the Super Admin), and I do not see anything for 2FA. I see the box for admin access, and that is unticked. Also, I see the link in my profile to disable it. The problem is that when I disable it, the very next page tells me that I have to re-enable it. I re-enable it, then get the email to remember the device for 30 days, but it asks me every time even when just accessing the forums. It asks if I use Chrome, after authenticating in Firefox. I have no idea what my users are experiencing because my site traffic has dropped off. If they are all getting this 2FA thing, I am doomed. I want to know if there is a way to disable it. I can start a new thread, I just do not know where to start it.

Not Brogan, nor do I play one on tv, but --

AdminCP > Users > Permissions/Usergroup Permissions > (Select given group) > General Permissions > Require two-step verification (Not Set/No should be fine).

Not sure where else you may have turned this on if you don't have the following checked:
AdminCP > Home > Options > Admin Control Panel > Require two-step verification to access the admin control panel

Also, I would expect to have to authenticate again in a new browser even if you verified in another. My guess, and it's just that, is that you're clearing (giving a 30-day "no challenge" pass to) individual browsers on individual machines, and that it's not some sort of global pass that gets you by on any browser on any machine. The latter would sort of defeat the purpose of 2FA.
 
Last edited:
Top Bottom