Tiny 2FA + Brute Force Protection

常見問題集

I locked myself out of my admin!

Try not to panic; you’re not permanently locked out and nothing has been lost. You’ll simply need to disable the Tiny 2FA plugin to regain access.

The simplest way to do that is to access your /wp-content/plugins folder via FTP and rename the /tiny-2fa folder to anything else. Once you’re back in your admin, you can restore the folder name and proceed to adjust your 2FA settings.

I’m positive I entered my username, password, and 2FA code correctly, but I still can’t log in!

There are a few quirks to check for that could disrupt the general 2FA process, which aren’t exclusive to Tiny 2FA:

1. The code you’re trying to enter may have expired. Even if you get a fresh code, you may need to reload the login page again first before trying the new code.
2. You may need to clear the browser cache and try again.
3. If you’re using Cloudflare, you’ll need to either restore visitor IPs or disable brute force protection.
4. If you’re using a caching plugin, make sure it doesn’t cache login pages or otherwise exclude your login page in its settings.
5. In your authenticator app, you may need to find and use a setting called something like “Sync Clock with Google.”

What 2FA methods are available?

Only TOTP at this time. This is the most common 2FA method, the one you’re probably most familiar with already. It’s more secure than 2FA via SMS or email, but not as secure as a hardware key (overkill for most people), which is probably the only other option I’d consider adding.

What apps are compatible?

There are many mobile, desktop, and browser apps that support TOTP, including: Google Authenticator, Microsoft Authenticator, Proton Authenticator, Ente Auth, Authy, Bitwarden, LastPass, and 1Password.

How do I generate a new secret key?

Simply regenerate (↻) in your profile settings to get a new key.

Can I store the site encryption key in wp-config.php?

Yes. For extra security, you can define your encryption key in wp-config.php:

define( 'TINY_2FA_ENCRYPTION_KEY', 'your-64-character-hex-key-here' );

You can find your current key in /wp-content/tiny-2fa-backup.php. This ensures your key survives database issues if somehow it’s lost.

How’s the security?

Other than storing secret keys in an encrypted format (apparently most sites just save them in plaintext), it’s a pretty standard implementation (but having any 2FA in place is infinitely more secure than no 2FA at all).

How’s the privacy?

As it turns out, generating QR codes is not a trivial matter. I explored generating them locally, but it added a lot of bloat to the plugin. So, I’ve opted to use an external service instead.

I’m using QuickChart (rather than Google, a popular choice) to generate QR codes, and for extra privacy, proxying the requests through Cloudflare.

QuickChart will only ever know the secret key, but not the site name, username, or IP address it belongs to. Cloudflare will know the server IP the request is coming from, but still not the name of the website or user.

How do Backup Codes work differently with your plugin?

The way I’ve envisioned Backup Codes is simple: immediately upon enabling 2FA, Backup Codes will be on by default. This means that you’ll receive codes by email until you’re certain you’ve set up an authentication app correctly, and then you should disable them.

Why do Backup Codes work differently with your plugin?

I don’t like the current implementation of the common Backup Codes feature that comes with most 2FAs. I think it creates a burden for the user to back them up, which if they’re capable of doing, they’re also capable of backing up their secret key in the first place without adding an unnecessary chore and new vulnerability while they’re at it.

I think I’ve been able to improve upon the concept of Backup Codes, at least in the WordPress environment where most users are going to be the admin of their own website anyway. The entire point of Backup Codes in the first place is to offer a second chance to avoid being locked out of your account in case you lost your secret key. But for most WordPress websites, and probably many websites in general these days, the added vulnerability doesn’t seem to match the intended usefulness.

I’m open to being wrong about this. If you feel my thinking is flawed or you have any other suggestion for improving the security of Tiny 2FA, please let me know.