Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Two-factor sign-in

How one person protects the administrator account and the accounts of relatives or club volunteers with two-step sign-in from sevenx_authentication_2fa - authenticator app or code by mail, setting it up, making it…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/individuals/running-it/two-factor-sign-in.md

On this page

Two-factor sign-in

This page is for individuals who want a stolen password to be useless. With two-step sign-in, after the password the site asks for a 6-digit code from an authenticator app on your phone, or one sent by mail. It ships with Exponential as sevenx_authentication_2fa (the root composer.json requires it; the installers activate it), and the full guide is Two-step sign-in.

Contents

  1. Why one person needs it most
  2. Setting it up for yourself
  3. App or mail
  4. If it is not offered yet
  5. Optional or required for others
  6. A lost phone
  7. Checklist

Why one person needs it most

When you run a site alone, your administrator account is the whole site: content, users, settings. Nobody else will notice a stranger signing in. Two-step sign-in is the single strongest protection for that account. Turn it on before launch.

Setting it up for yourself

  1. Sign in, open My account > Two-step sign-in (/user2fa/setup).
  2. Choose Authenticator app and scan the QR code with an app such as any RFC 6238 authenticator (the extension's README.md names Google Authenticator, Authy and Microsoft Authenticator), or type the key shown.
  3. Enter the code the app shows. Until you do, nothing changes.
  4. Sign out and in again to see it work.

The key is not shown again. If your app offers an encrypted backup of its codes, use it.

Setting up two-step sign-in
Setting up two-step sign-in

App or mail

MethodGoodLess good
Authenticator appWorks without mail; codes change every 30 secondsNeeds a phone and a little care when the phone is replaced
Code by mailNothing to install; good for less technical relativesOnly as safe as the mailbox; depends on working mail

Use the app for your administrator account. Offer mail codes to readers who struggle with apps.

If it is not offered yet

On an older or custom installation an administrator may need to switch it on once (Two-step sign-in, Turning it on):

  1. The extension and its login handler (sevenxUser2fa before standard) in settings/override/site.ini.append.php.
  2. A field of the datatype 7x 2FA Configuration on the user class.
  3. The policies user2fa/setup and user2fa/verify for every role that signs in (Member, Editor, Administrator).
  4. Recommended: a SecretKey in settings/override/sevenxauthentication2fa.ini.append.php that encrypts the stored secrets; keep it safe, losing it means everyone sets up the app again.

On your own site, you are that administrator.

Optional or required for others

[General] Enforce2FADefaultMethodEffect
disabled (default)anyEach person opts in
enabledtotpA person without a second step sets up the app right after the password
enabledemailA person without a second step gets mail codes straight away

A sensible split for a family or club site: required (app) for administrators and editors, optional for readers. Enroll yourself first, so you are never locked out by your own switch (Accounts, passwords and two-step sign-in).

A lost phone

For someone else: open their user object in the administration, set the Two-step sign-in field to E-mail one-time code or Disabled, and publish; they sign in and set up the app again.

For yourself, as the only administrator: prevent the problem.

  • Keep a second administrator account (a deputy's, or your own emergency account with a long password kept offline) (Sharing the work with volunteers).
  • Or set your own method to mail codes temporarily before changing phones.

Checklist

  • To do: Your administrator account uses the app.
  • To do: A second administrator account exists and is protected.
  • To do: Editors and volunteers use two-step sign-in.
  • To do: Readers can opt in.
  • To do: SecretKey set and backed up somewhere safe.
  • To do: You know how to reset someone's second step.

Become an Exponential Partner

Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x