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

sevenx_authentication_2fa: Zwei-Faktor- und Social-Login

Diese Seite ist für Administratoren, die eine stärkere Anmeldung möchten, und für Website-Entwickler, die „Mit Google anmelden“ und Ähnliches anbieten. sevenx_authentication_2fa fügt Exponential 6…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/features/6.0/extensions/sevenx_authentication_2fa.md

On this page

This page is a translation. Read the English original

sevenx_authentication_2fa: Zwei-Faktor- und Social-Login

Diese Seite ist für Administratoren, die eine stärkere Anmeldung möchten, und für Website-Entwickler, die „Mit Google anmelden“ und Ähnliches anbieten. sevenx_authentication_2fa fügt Exponential 6 Zwei-Faktor-Authentifizierung und Social Login über OAuth hinzu. Sie wurde am 21. Juli 2026 importiert (1.0.0) und hat minimale Abhängigkeiten: Sie ist mit PHP 8.5.8 kompatibel, braucht für TOTP nur die Erweiterung hash und für OAuth curl oder allow_url_fopen.

Was sie bietet

  • TOTP (RFC 6238) nur mit eingebauten Mitteln von PHP: Google Authenticator, Authy, Microsoft Authenticator und jede RFC-konforme App.
  • Einmalcode per E-Mail, wenn TOTP nicht verfügbar ist oder die gewählte Methode ist, gesendet mit eZMail, mit einem fortsetzbaren Link /user2fa/verify/code/<code>, der die Anmeldung beim Anklicken abschließt, auch in einem anderen Browser.
  • Einen Datentyp sevenxauthentication2fa an der Klasse user, sodass Benutzer ihre eigene Methode und ihr Geheimnis einrichten.
  • Einen Login-Handler sevenxUser2fa, der das Passwort prüft und dann die Anmeldung abschließt oder zur Abfrage weiterleitet.
  • Eine Oberfläche zum Zurücksetzen der 2FA, eine Zurück-Schaltfläche und Templates für das Bearbeiten von Benutzern, die Registrierung und den Fall der erzwungenen Einrichtung (ein Benutzer ohne eingerichtete Methode, der eine einrichten muss, bevor er die Website verwendet).
  • Handler für Social Login (Gerüste, bereit zum Anpassen) für Google, Facebook, Twitter/X, Instagram, Meta und ID.me, eine Basisklasse und einen Kommandozeilen-Generator für weitere Anbieter.
  • Kein Redis oder Valkey nötig: Offene Abfragen sind JSON-Dateien in var/site/cache/sevenx_2fa_pending/, mit Benutzer-ID und Hash des Codes als Schlüssel, entfernt bei Erfolg und vom Aufräumskript.

Einrichten

  1. Aktivieren Sie die Extension und ihren Login-Handler in settings/override/site.ini.append.php:
[ExtensionSettings]
ActiveExtensions[]=sevenx_authentication_2fa
[UserSettings]
ExtensionDirectory[]=sevenx_authentication_2fa
LoginHandler[user2fa]=sevenxUser2fa
LoginHandler[]=standard

Der Standard-Handler meldet den Benutzer an, bevor die Abfrage laufen kann, daher muss er nach sevenxUser2fa stehen. Entfernen oder kommentieren Sie ein LoginHandler[]=standard in settings/site.ini aus, damit die Reihenfolge der Überschreibung wirkt.

  1. Erzeugen Sie die Autoloads neu und leeren Sie die Caches:
php bin/php/ezpgenerateautoloads.php -e
php bin/php/ezcache.php --clear-all --allow-root-user
  1. Gewähren Sie die Richtlinien (unten).
  2. Melden Sie sich als Testbenutzer an und öffnen Sie /user2fa/setup, um TOTP oder E-Mail einzuschalten.

Rollenrichtlinien

Das Modul user2fa hat vier Funktionen: setup, verify, oauth und callback. Gewähren Sie sie nur über Rollen und Richtlinien:

AnsichtGewähren
/user2fa/oauth/<provider>user2fa/oauth der Rolle Anonymous
/user2fa/callback/<provider>user2fa/callback der Rolle Anonymous
/user2fa/verify, /user2fa/verify/code/<code>user2fa/verify der Rolle Anonymous und jeder Rolle, die 2FA verwendet
/user2fa/setupuser2fa/setup den Rollen, die ihre eigene 2FA verwalten (Member, Editor, Partner, Administrator, eigene Rollen)

Die Ansichten prüfen ihren eigenen Zustand: verify verarbeitet eine Anfrage nur, wenn eine gültige offene Abfrage existiert.

Verwenden

  • Zwei-Faktor: Benutzer öffnen /user2fa/setup, um TOTP- oder E-Mail-2FA einzuschalten. Die Seite zeigt das Geheimnis, eine URI otpauth:// und einen QR-Code. Das QR-Bild wird über die Google Chart API erzeugt; wenn Sie keinen externen Dienst wollen, verwenden Sie die URI oder das einfache Geheimnis.
  • Social Login: Legen Sie beim Anbieter eine OAuth-Anwendung an, füllen Sie den Block des Anbieters aus, setzen Sie [SocialLogin] Enabled=enabled in sevenxauthentication2fa.ini (der Hauptschalter, Standard disabled) und verlinken Sie auf /user2fa/oauth/<provider>. Der Anbieter kehrt zu /user2fa/callback/<provider> zurück.
  • Einen Anbieter hinzufügen: Das legt den Handler an und hängt seinen INI-Block an; bearbeiten Sie dann normalizeUserInfo():
php extension/sevenx_authentication_2fa/bin/php/sevenx2fabuild.php --provider=MyProvider --client-id=... --client-secret=... --authorization-url=... --token-url=... --userinfo-url=... --scope="email profile"
  • Die Zugangsdaten eines Anbieters setzen, ohne die INI-Datei zu bearbeiten: Das schreibt die passende sevenxauthentication2fa.ini.append.php in settings/override (oder in den Siteaccess-Ordner) und leert den INI-Cache. Es ändert Einstellungen: Führen Sie es nur aus, wenn Sie das wollen.
php extension/sevenx_authentication_2fa/bin/php/sevenx2faconfig.php --provider=Google --siteaccess=<siteaccess> --client-id=... --client-secret=...
  • Aufräumen: entfernt abgelaufene Abfragen (auch als Cronjob-Skript verwendbar):
php extension/sevenx_authentication_2fa/bin/php/sevenx2facleanup.php

Einstellungen

Alle Schlüssel stehen in sevenxauthentication2fa.ini.

BlockSchlüsselStandardBedeutung
GeneralEnabledenabledZwei-Faktor ein oder aus
GeneralIssuerExponentialIn der Authenticator-App angezeigter Name
GeneralDefaultMethoddisabledtotp, email oder disabled
GeneralEnforce2FAdisabledBenutzer ohne Methode zwingen, eine einzurichten
GeneralAllowEmailFallbackenabledDen Code per E-Mail als Rückfall erlauben
CodeSettingsLength, TimeStep, Window, Algorithm6, 30, 1, SHA1TOTP-Parameter
CodeSettingsEmailTTL600Sekunden, die ein Code per E-Mail gilt
EmailSettingsSubject, SenderYour login verification code is {code}, leerBetreff und Absender der E-Mail
EmailSettingsBodyleerOptionaler Text mit {code}, {expires}, {site_url}, {verify_url}; leer verwendet das Template
TOTPSettingsSecretLength20Länge des Geheimnisses
SocialLoginEnabled, AutoCreateUserdisabled, disabledHauptschalter des Social Login; unbekannte Benutzer anlegen
SocialLoginDefaultUserGroupNodeID, AuthenticationMatch12, emailGruppe automatisch angelegter Benutzer; Konten nach E-Mail zuordnen
<Provider> (Google, Facebook, TwitterX, Instagram, ...)Enabled, ClientID, ClientSecret, Scope, AuthorizationURL, TokenURL, UserInfoURLaus, leerEin Block pro Anbieter

Der Text der E-Mail ist das Template design/standard/templates/mail/2fa_code.tpl (Variablen $code, $expires, $site_url, $verify_url); kopieren Sie es in Ihr Website-Design, um es mit Ihrer Marke zu versehen. Halten Sie Client-Geheimnisse in settings/override/, nie in der eigenen Einstellungsdatei der Extension unter Versionsverwaltung.

Verwandte Seiten

Werden Sie Exponential-Partner

Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.

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