Zum Inhalt springen

enno.dev Commerce Partner

  • Startseite
  • Shopware 5
  • Shopware 6
  • Deutsch
    • Deutsch
    • English

Shopware 5

10
  • Awin Conversion Tracking, Remarketing und Server-to-Server-Tracking
  • Eigenschaften UND-Verknüpfung in den Filtern
  • Einlösbare Gutscheine je Kunde auch bei Gastbestellungen beschränken
  • ESD Multi-Download
  • Globale Preisänderungen
  • Registrierungsfilter gegen Spam-Anmeldungen
  • Suchbegriffe von der Suche ausschließen oder umleiten
  • Tabs Advanced: Alle Tabs zentral verwalten
  • Vorausgewählte Filter
  • Warenkorb leeren per Button

Shopware 6

11
  • Debug für Produktivsysteme
  • Digitale Produkte und Downloads (ESD)
  • Import mit Artikelnummern: Produkte über die Produktnummer aktualisieren
  • Produktlink statt Warenkorb Button
  • Registrierungsfilter gegen Spam-Anmeldungen
  • Sentinel Admin Security: 2FA, Login-Sperre, Dateityp-Prüfung
  • Tabs Advanced: Alle Tabs zentral verwalten
  • Tabs Advanced Erweiterung: Anker Tabs mit Sprungmarken
  • Tabs Advanced Erweiterung: Objekt-Zusatzfelder als Links ausgeben
  • Tabs Advanced Erweiterung: Produkt-Detailseite Layout-Zuweisung
  • Warenkorb leeren per Button
Kategorien anzeigen
  • Shopware 6
  • Sentinel Admin Security: 2FA, Login-Sperre, Dateityp-Prüfung

Sentinel Admin Security: 2FA, Login-Sperre, Dateityp-Prüfung

Version 2.2.0 Shopware ab 6.7.14 Stand 3. November 2026

Sentinel schützt die Administration Ihres Shops. Zum Passwort kommt ein Code aus einer Authenticator-App, eine IP-Adresse mit zu vielen Fehlversuchen wird gesperrt, die Administration zieht auf Wunsch von /admin an eine eigene Adresse um und Uploads werden auf ihren tatsächlichen Dateityp geprüft.

Für Shopware 6.5 bis 6.7.13 gibt es ältere Versionen des Plugins ohne Zwei-Faktor-Anmeldung. Diese Anleitung beschreibt Version 2.2.0.

Im Shopware Store ansehen

Was das Plugin kann #

Zwei-Faktor-Anmeldung #

Nach dem Passwort geben Admin-Benutzer einen sechsstelligen Code aus einer Authenticator-App ein, zum Beispiel Google Authenticator, Microsoft Authenticator oder 1Password. Statt des Codes geht auch einer von zehn Backup-Codes, jeder einmal. Erst wenn beides stimmt, ist der Benutzer angemeldet.

Jeder Benutzer richtet die Zwei-Faktor-Anmeldung selbst ein, unter seinem Profil im Reiter "Sicherheit". Dort erneuert er auch die Backup-Codes oder entfernt sie wieder. Beim Einrichten enden alle seine Sitzungen, die ohne Code begonnen haben, er meldet sich also einmal neu an.

Sie können die Zwei-Faktor-Anmeldung für Administratoren oder für alle Benutzer zur Pflicht machen, mit einer Übergangsfrist. Wer sie danach noch nicht eingerichtet hat, wird beim Login durch die Einrichtung geführt. Falsche Codes sind je Konto begrenzt: Nach fünf Fehlversuchen heißt es 15 Minuten warten, nach jeweils fünf weiteren doppelt so lang, höchstens einen Tag.

Hat ein Benutzer sein Smartphone verloren, setzt ein Administrator die Zwei-Faktor-Anmeldung in den Benutzerdaten zurück. Die Benutzerliste zeigt, wer sie eingerichtet hat. Das Zurücksetzen dürfen auch Benutzer mit der Berechtigung "Zwei-Faktor-Anmeldung anderer Benutzer zurücksetzen".

IP-Sperre nach Fehlversuchen #

Nach der eingestellten Zahl fehlgeschlagener Logins wird die IP-Adresse für 30 Minuten von der Administration und der Admin-API ausgesperrt. Jeder weitere Fehlversuch nach einer Sperre verlängert die nächste Sperre um 30 Minuten. Ein erfolgreicher Login setzt den Zähler zurück, ebenso 24 Stunden ohne Fehlversuch und ohne laufende Sperre. Die Storefront bleibt erreichbar. Adressen aus der Liste der Ausnahmen werden nie gesperrt.

Gespeichert werden IP-Adressen nur für die Sperre und den letzten erfolgreichen Login. Eine geplante Aufgabe löscht täglich alle Einträge, die 30 Tage unverändert sind.

Eigene Admin-URL #

Statt unter /admin erreichen Sie die Administration unter einem eigenen Pfad, zum Beispiel /backoffice. Unter /admin ist sie danach nicht mehr erreichbar.

Prüfung beim Upload #

Die Medienverwaltung lehnt Dateien ab, deren Inhalt nicht zur Dateiendung passt, zum Beispiel ein PDF-Dokument, das in .jpg umbenannt wurde.

Installation und Einrichtung #

  1. Installieren Sie das Plugin unter Erweiterungen > Meine Erweiterungen und aktivieren Sie es.
  2. Öffnen Sie dort die Konfiguration von "Sentinel Admin Security".
  3. Lassen Sie unter "Login-Schutz" die IP-Sperre eingeschaltet und legen Sie die Zahl der erlaubten Fehlversuche fest. Tragen Sie unter "IP-Ausnahmen" die Adressen Ihres Büros oder Ihrer Agentur ein.
  4. Richten Sie zuerst Ihre eigene Zwei-Faktor-Anmeldung ein: Benutzermenü unten links, Profil, Reiter "Sicherheit".
  5. Legen Sie dann unter "Zwei-Faktor-Anmeldung" fest, für wen sie Pflicht ist und wie lang die Übergangsfrist ist.
  6. Wenn in Ihrem Team niemand mit persönlichen API-Schlüsseln arbeitet, schalten Sie unter "API-Zugänge" "Alle persönlichen API-Schlüssel sperren" ein.
  7. Wenn Sie eine eigene Admin-URL möchten, wählen Sie oben "Alle Verkaufskanäle", tragen den Pfad unter "Eigener Admin-Pfad" ein und speichern. Notieren Sie sich die neue Adresse vorher.

Damit gespeicherte IP-Adressen gelöscht werden, müssen die geplanten Aufgaben und der Message-Worker des Shops laufen. Steht der Shop hinter einem Load Balancer oder CDN, konfigurieren Sie TRUSTED_PROXIES, damit Shopware die IP-Adresse des Besuchers sieht und nicht die des Proxys.

Einstellungen #

Die Einstellungen für die Zwei-Faktor-Anmeldung und die Admin-URL gelten für den ganzen Shop und lassen sich nur unter "Alle Verkaufskanäle" ändern.

EinstellungVorgabeWirkung
IP-Adressen nach fehlgeschlagenen Admin-Logins sperrenanSchaltet die IP-Sperre ein.
Erlaubte Fehlversuche beim Login3Der Fehlversuch nach dem letzten erlaubten sperrt die Adresse für 30 Minuten.
IP-AusnahmenleerAdressen, die nie gesperrt werden, getrennt durch Komma, Semikolon oder Leerzeichen. Bereiche gehen nicht.
Zwei-Faktor-Anmeldung für Admin-BenutzerFreiwilligAus, Freiwillig, Pflicht für Administratoren oder Pflicht für alle Benutzer.
Übergangsfrist in Tagen7So lange kann sich ein Benutzer noch ohne Code anmelden. Die Frist beginnt mit seinem ersten Login, nachdem die Pflicht galt. 0 heißt: Einrichtung beim nächsten Login.
Code auch bei der Passwort-Bestätigung abfragenausShopware fragt vor Änderungen an Benutzern, Rollen oder dem eigenen Profil erneut nach dem Passwort. Eingeschaltet kommt dort der Code dazu.
Alle persönlichen API-Schlüssel sperrenausWeist jeden persönlichen API-Schlüssel ab, auch bestehende. Integrationen funktionieren weiter.
Eigener Admin-PfadleerErsetzt /admin. 3 bis 64 Zeichen: Buchstaben, Ziffern, Bindestrich und Unterstrich, am Anfang ein Buchstabe oder eine Ziffer.
Dateityp beim Upload prüfenanLehnt Uploads ab, deren Inhalt nicht zur Endung passt. Schalten Sie das nur ab, wenn eine korrekte Datei abgelehnt wird.

Wer die Zwei-Faktor-Anmeldung von "Aus" auf eine andere Stufe stellt, meldet alle Benutzer ab, die sie eingerichtet haben. Ihre Sitzungen laufen erst nach einem Login mit Code weiter.

Persönliche API-Schlüssel #

Ein persönlicher API-Schlüssel handelt als sein Benutzer, ohne Passwort und ohne zweiten Faktor. Deshalb weist Sentinel die Schlüssel aller Benutzer ab, für die die Zwei-Faktor-Anmeldung Pflicht ist, auch während der Übergangsfrist. Mit dem Schalter "Alle persönlichen API-Schlüssel sperren" gilt das für alle. Automatisierungen, die weiterlaufen sollen, nutzen eine Integration unter Einstellungen > System > Integrationen.

Ist ein Schlüssel in falsche Hände geraten, reicht das Sperren nicht. Löschen Sie den Schlüssel in den Einstellungen des Benutzers, prüfen Sie Integrationen und Benutzer und ändern Sie das Passwort des Benutzers.

Eigene Admin-URL #

Der Pfad wird in die Datei .env im Hauptverzeichnis des Shops als SHOPWARE_ADMINISTRATION_PATH_NAME geschrieben. Leeren Sie das Feld, ist die Administration wieder unter /admin erreichbar. Steht die Variable schon in .env.local, .env.local.php oder in der Server-Umgebung, meldet das Plugin das, statt zu speichern.

Die Datei .env muss beschreibbar sein. Läuft der Shop auf mehreren Anwendungsservern, hat jeder seine eigene .env. Setzen Sie die Variable dann im Deployment.

Ausgesperrt? #

Kann sich niemand mehr anmelden, weil zum Beispiel der einzige Administrator Smartphone und Backup-Codes verloren hat, setzen Sie seine Zwei-Faktor-Anmeldung auf dem Server zurück:

php bin/console enno-sentinel:mfa:reset benutzername

Mit --all statt eines Benutzernamens setzen Sie alle zurück. Ist die Zwei-Faktor-Anmeldung Pflicht, richtet der Benutzer sie beim nächsten Login neu ein.

Funktioniert der Login selbst nicht mehr, etwa weil nach einem Shopware-Update der Dialog für den Code fehlt, schalten Sie die Zwei-Faktor-Anmeldung aus oder deaktivieren das Plugin:

php bin/console system:config:set EnnoSentinel.config.mfaPolicy off
php bin/console plugin:deactivate EnnoSentinel
php bin/console cache:clear

Häufige Fragen #

Was passiert, wenn sich das APP_SECRET des Shops ändert?

Die Schlüssel der Zwei-Faktor-Anmeldung und die Backup-Codes hängen am APP_SECRET. Ändert es sich, funktionieren weder die Authenticator-Apps noch die Backup-Codes. Setzen Sie dann alle mit enno-sentinel:mfa:reset --all zurück, die Benutzer richten die Zwei-Faktor-Anmeldung neu ein.

Wie verhält sich das Plugin mit Single Sign-on?

Bei einer Anmeldung per Single Sign-on übernimmt der Identity Provider den zweiten Faktor. Sentinel fragt den Code nur bei Logins mit Passwort ab und beendet keine laufenden Sitzungen von Benutzern ohne Zwei-Faktor-Anmeldung. Persönliche API-Schlüssel umgehen auch den Identity Provider, deshalb weist das Plugin sie nach der Regel oben auch hier ab.

Zählt ein falscher Code zur IP-Sperre?

Nein. Ein richtiges Passwort mit fehlendem oder falschem Code zählt nicht zur IP-Sperre. Falsche Codes sind stattdessen je Konto begrenzt.

Was passiert bei der Deinstallation?

Eine über das Plugin gesetzte Admin-URL wird aus der .env entfernt, die Administration ist wieder unter /admin erreichbar. Das gilt auch, wenn Sie die Benutzerdaten behalten. Ohne diese Option löscht die Deinstallation alle Einrichtungen der Zwei-Faktor-Anmeldung. Ist die .env nicht beschreibbar, löschen Sie die Zeile SHOPWARE_ADMINISTRATION_PATH_NAME von Hand und leeren den Cache.

Hinweise zum Update #

Update auf 2.2.0 #

  • Neu ist die Zwei-Faktor-Anmeldung. Ab Werk ist sie freiwillig, niemand muss sie nach dem Update einrichten.
  • Die IP-Sperre betrifft die Storefront nicht mehr, gespeicherte IP-Adressen werden nach 30 Tagen gelöscht.
  • Die Admin-URL wirkt sofort ohne Leeren des Caches und wird bei der Deinstallation entfernt.
  • Die Prüfung beim Upload prüft den Inhalt der Datei, Office- und Windows-Media-Dateien werden nicht mehr fälschlich abgelehnt.
  • Benötigt Shopware 6.7.14 oder neuer.

Alle Änderungen je Version stehen im Changelog auf der Seite des Plugins im Shopware Store.

Hilfe #

Hilft Ihnen diese Anleitung nicht weiter, schreiben Sie uns über das Kontaktformular auf enno.dev.

Inhalt
  • Was das Plugin kann
    • Zwei-Faktor-Anmeldung
    • IP-Sperre nach Fehlversuchen
    • Eigene Admin-URL
    • Prüfung beim Upload
  • Installation und Einrichtung
  • Einstellungen
  • Persönliche API-Schlüssel
  • Eigene Admin-URL
  • Ausgesperrt?
  • Häufige Fragen
  • Hinweise zum Update
    • Update auf 2.2.0
  • Hilfe

enno.dev Commerce Partner

Shopware-Plugins
  • Shopware 6
  • Shopware 5
  • Alle Plugins im Shopware Store
Kontakt
  • Kontaktformular
  • enno.dev
  • Commerce Partner
Rechtliches
  • Impressum
  • Datenschutz