2-factor authentication coming to ProcessWire

This week we're going to talk about a new feature that’s currently in development on the dev branch: 2-factor authentication.

This will likely be introduced in version 3.0.109 or 3.0.110). The development branch remains on version 3.0.108 this week, though it does have several updates relative to this time last week, mostly for resolution of GitHub issue reports.

About 2-factor authentication

A new security feature coming soon to the ProcessWire dev branch is the addition of optional 2-factor authentication (also known as two-step verification, multi-factor authentication, 2FA, TFA, etc). Just in case you aren't already familiar with this, two-factor implies an authentication system where you login with your username and password as usual, but with a second step that protects your account, even if someone were to ever get a hold of your password. The second step consists of a unique and usually random code to verify your identity, and it is most commonly sent to you via an app on your phone or SMS.

Why 2-factor authentication?

These days I'm using two factor authentication on just about every online account that I have, anywhere that it's available. With every online service being under pretty much constant attack, our increasing reliance upon these services, and the companies behind them seemingly not being so careful with our data, 2FA is reaching a point of becoming essential.

With ProcessWire's emphasis on security, it just seems like it should be built into the PW core too. It really adds a lot of security, it sets a good example, and it's something that is becoming increasingly important when it comes to online application security. It's not just about you and me, but even more so about our clients and the people that we work with—people that sometimes don't know or use best practices when it comes to passwords. 2-factor authentication is a great way to add even more protection and security for our clients and the sites that we develop for them.

How we are implementing it

Two factor authentication is being built directly into our admin login module (ProcessLogin), but it will use separate modules as the actual providers for two factor authentication. This will enable us to support different types 2-factor authentication and different providers. Much in the same way that we support different types of email providers with WireMail modules. The module approach will also enable people to more easily utilize 2FA on the front-end, like with the LoginRegister module.

Google Authenticator (to start)

The first provider module will be for Google Authenticator, which I've already been using, and am guessing some of you might already be using elsewhere (like Google, Amazon, Facebook, GitHub, etc). Google Authenticator is an app that you can install on your phone (Android and iPhone), and it provides random codes that can be used as a second step to authenticate your login identity. It's also free for both user and client at any scale, doesn't rely on SMS (or fees associated with text messages), and is generally very simple, and it seemed like a good default implementation to start with. Though there are a lot of other options too (some more powerful and full featured), so this is just where we'll start our implementation.

2-factor authentication process

In ProcessWire, 2-factor authentication has to first be enabled in the ProcessLogin module settings. Once enabled, individual users can enable 2-factor authentication for their account in the ProcessWire user profile editor.

ProcessWire asks the user to take a photo of a QR code on the screen with the Google Authenticator app. This QR code represents a user-unique secret that is shared this one time between Google Authenticator and ProcessWire, enabling Google Authenticator to generate codes that correspond to the user in ProcessWire. Once the secret (represented by a QR code) has been read, Google Authenticator gives the user a 6-digit code to type back into ProcessWire, just to make sure it works. The user hits save, and then they are done.

In the future, when the user logs in, they'll type in their username and password as usual, but the next screen asks them for a 6-digit code that appears on their phone. These codes are randomly generated every 30 seconds.

Other 2-factor authentication methods

The WireMail-like module approach will likely result in more two-factor authentication methods becoming available, services like Authy, SMS-based and others. I also want to mention that Netcarver (from the forum) was on top of this back in 2012 when he developed the PPP 2-factor authentication module for ProcessWire. While it's a different kind of 2-factor authentication (utilizing email delivered and/or printed codes), I'm hopeful that it will be one that becomes available in the new module format as well.

The 2-factor authentication in ProcessWire is in the early stages of development, and it'll likely be another 1-2 weeks before the initial version is committed to the dev branch. There's a lot more to write about it, so look for more details in future blog posts here.

Start using 2FA now in the ProcessWire forums

While we're on the subject, I also wanted to mention that I've enabled Google Authenticator-based 2FA in the ProcessWire forums. If you'd like to enable it for your account, do the following:

  1. Login to the forums.
  2. Click your name in the top right (dropdown) and click on “Account Settings”.
  3. Click “Account Security” in the sidebar on the left.
  4. From here, you can setup Google Authenticator 2-factor authentication.

Next week I'm scheduled to work with another ProcessWire user on PW-based development project on a quick timeline, so there might not be a blog post next week, depending on how quickly we finish the project. I hope that you all have a great weekend, and enjoy reading the ProcessWire Weekly for the latest ProcessWire news and updates.


  • Pete


    • 6 years ago
    • 10

    I'd prefer it if an administrator then had to reset access for you. It's alright for a Superuser account to get locked out as there are always other ways back in if you have FTP access but would be good to have a role you can assign to certain user groups to somehow reset other users' 2FA somehow.

    I suspect this would mostly be in business environments anyway (and generally security-conscious devs) so hopefully nobody would be catastrophically locked out, just inconvenienced for a while.

    • ben


      • 6 years ago
      • 00

      True, and I like the idea of having a role being able to reset someones access. Just thought its worth mentioning as im not totally convinced by googles app on its own, but together with other factors it can work ok (e.g. some way of recovery that maybe invoives backup passwords or information, not simply a email reset)

    • carl


      • 6 years ago
      • 00

      The 2nd factor can be offline temporarily for simple reasons like an empty phone battery. Funny things happen while traveling. To accept to be "inconvenienced" for a while can cost money. What about a 3rd factor as a fallback (example iPhone-APP method does not work but the email-method works)?

  • Pete


    • 6 years ago
    • 30

    Looking forward to being able to implement this on the front-end of a few projects where I'm using PW as the basis for customer portals - good timing!

    Also I seem to recall that the Google Authenticator app used to be interchangeable with the Microsoft Authenticator app and a few others. Not sure if that's still the case but I think a lot of them are built around the same standards at least.

    Good to hear that other options will be available in future too as I know some find the SMS authentication simpler.

  • Ben


    • 6 years ago
    • 40

    Two factor is ace but suffers when you don’t have access to the second factor. What will PW do in this case? (E.g. if you get a new phone the Auth app doesn’t save your accoutants) And if it’s just a email reset is it not the same difference?

    • Mont


      • 6 years ago
      • 10

      Any Yubikey devs out there. Would love Yubikey for Processwire.

      Thanks for your dedication Ryan.

    • carl


      • 6 years ago
      • 00

      WORKS GREAT already!


    PrevProcessWire 3.0.108 core updates


    Continuing from last week's post, ProcessWire 3.0.108 is now available on the dev branch, and it adds support for a new, more powerful live search in the admin. This week we will take a closer look at how it works, as well as how module developers can make their modules searchable too.  More 

    NextProcessWire 3.0.109 adds two-factor authentication


    In the last blog post I told you about how two-factor authentication was coming to the core and what our plans were. This week it's ready to use in ProcessWire 3.0.109, so we'll take a closer look at all the details and how to use it. More 

    Latest news

    • ProcessWire Weekly #524
      In the 524th issue of ProcessWire Weekly we'll check out what's new in the core this week, introduce a new module called SEO Text Width, and more. Read on!
      Weekly.pw / 25 May 2024
    • ProFields Table Field with Actions support
      This week we have some updates for the ProFields table field (FieldtypeTable). These updates are primarily focused on adding new tools for the editor to facilitate input and management of content in a table field.
      Blog / 12 April 2024
    • Subscribe to weekly ProcessWire news

    “Indeed, if ProcessWire can be considered as a CMS in its own right, it also offers all the advantages of a CMF (Content Management Framework). Unlike other solutions, the programmer is not forced to follow the proposed model and can integrate his/her ways of doing things.” —Guy Verville, Spiria Digital Inc.