# Handbuch Sicherheitscenter für Shopware 6

> Handbuch zum Sicherheitscenter: erste Prüfung, Funde beheben, Zwei-Faktor-Anmeldung, Länder-Sperre, Protokoll, Datenschutz und alle Einstellungen.

Quelle / Source: https://stoneandwater.online/de/handbuch-sicherheitscenter.html

## Was das Plugin macht

Das Sicherheitscenter prüft deinen Shop regelmäßig auf Skimmer, Schadcode, veränderte Dateien, schwache Zugänge, kritische Änderungen an Einstellungen und bekannte Sicherheitslücken. Jede Auffälligkeit wird als Fund mit Stufe, Erklärung und Schritten zur Behebung gespeichert.
Zusätzlich schützt das Plugin die Anmeldung an der Administration: mit Zwei-Faktor-Anmeldung, Länder-Sperre, einer Liste erlaubter Adressen, einem Anmelde-Protokoll und einem Protokoll aller kritischen Änderungen.
Prüfung, kein Schutzversprechen: Die Prüfung meldet Auffälligkeiten und Änderungen. Sie verhindert keinen Angriff und findet nicht jeden Schadcode. Jeder Fund sollte angesehen werden, bevor er bestätigt wird.
Shopware 6.6 und 6.7: Das Plugin läuft auf beiden Versionen, in Deutsch und Englisch, mit Dunkelmodus. Bis Version 1.5 hieß es Sicherheits-Scanner.

## Erste Schritte

- Plugin über die Plugin Suite installieren und aktivieren.
- Unter Erweiterungen das Sicherheitscenter öffnen und die Lizenz prüfen.
- In der Übersicht auf Jetzt prüfen klicken. Die erste Prüfung erfasst den Ausgangszustand.
- Die Funde der ersten Prüfung durchgehen: schwache Passwörter, bekannte Lücken und offene Dateien zeigt schon der erste Lauf.
- Die Liste Empfohlene Einrichtung in der Übersicht abarbeiten: Zwei-Faktor-Anmeldung, Benachrichtigung, Kopfzeilen und was sonst noch fehlt.

## Lizenz aktivieren

Die Lizenz wird über die Plugin Suite zugewiesen und beim ersten Öffnen automatisch geprüft. Ohne gültige Lizenz zeigt das Plugin die Lizenzansicht, in der du den Schlüssel einträgst. Ohne Lizenz läuft keine Prüfung, und der Anmeldeschutz greift nicht: Niemand wird durch eine abgelaufene Lizenz ausgesperrt.

## Die erste Prüfung und der Ausgangszustand

Bei der ersten Prüfung merkt sich das Plugin zu jeder Datei eine Prüfsumme und zu kritischen Einstellungen den aktuellen Wert. Das ist der Ausgangszustand. Ab der zweiten Prüfung wird jede Abweichung gemeldet: neue, geänderte und gelöschte Dateien, neue Administratoren, geänderte Zahlungsarten.
Der Ausgangszustand sollte sauber sein. Wenn du den Verdacht hast, dass der Shop bereits verändert wurde, schau dir zuerst die Funde der Bereiche Schadcode und Original-Abgleich an, die auch ohne Ausgangszustand arbeiten.
Unter Einstellungen, Verzeichnisse lässt sich der Ausgangszustand mit Neu erfassen verwerfen, zum Beispiel nach einem Umzug.

## Übersicht und Sicherheits-Kennzahl

Die Übersicht zeigt die Sicherheits-Kennzahl von 0 bis 100, die offenen Funde nach Stufe, die letzte Prüfung und die Zahl der geprüften Dateien. Die Kennzahl sinkt mit jedem offenen Fund, bei hohen Stufen stärker. Bestätigte und behobene Funde zählen nicht.
Empfohlene Einrichtung listet die Schutzfunktionen, die noch nicht eingerichtet sind. Einschalten aktiviert eine Funktion sofort, Einrichten führt zur passenden Stelle. Was du für diesen Shop nicht brauchst, blendest du aus.
Verlauf der Kennzahl zeigt die Kennzahl am Ende der letzten Prüfungen, höchstens 30. Die Kurve beginnt mit der zweiten Prüfung und steht auch im PDF-Bericht.
Darunter stehen die fremden Skripte der Storefront, die letzten Anmeldungen an der Administration, die Quarantäne und die letzten Prüfungen. Über PDF-Bericht lädst du den aktuellen Stand als PDF.

## Funde lesen und bestätigen

Jeder Fund hat eine Stufe: Hoch braucht sofort Aufmerksamkeit, Mittel sollte zeitnah geprüft werden, Niedrig ist eine Schwäche ohne akute Gefahr, Hinweis dient der Information.
Details zeigt, was gefunden wurde, die Empfehlung und alle Angaben zum Fund. Ist der Fund in Ordnung, klickst du auf Bestätigen. Er gilt dann als geprüft und meldet sich erst wieder, wenn sich etwas ändert. Ist die Ursache beseitigt, schließt die nächste Prüfung den Fund von selbst.
Nach einem Shopware- oder Plugin-Update ändern sich viele Dateien. Mit Alle Datei-Änderungen bestätigen übernimmst du sie in einem Schritt. Mehrere Funde lassen sich über die Auswahl gemeinsam bestätigen.

## Schritte zur Behebung

Die Details eines Funds nennen nummerierte Schritte zur Behebung. Dieselben Schritte stehen in der E-Mail und im PDF-Bericht.
Bei Sicherheitslücken unterscheidet das Plugin, woher das betroffene Paket kommt: Shopware selbst, ein Paket, das Shopware mitbringt, ein Plugin oder das eigene Projekt. Danach richtet sich, ob ein Shopware-Update, ein Plugin-Update oder ein Befehl wie composer update hilft. Der Befehl steht fertig zum Kopieren im Fund.
Mehrere Lücken mit derselben Ursache fasst das Plugin zu einem Fund zusammen, zum Beispiel alle Symfony-Pakete, die ein Shopware-Update gemeinsam behebt.

## Die Prüfbereiche

- Dateien: neue, geänderte und gelöschte Dateien, PHP in Medienordnern, Schadcode-Muster.
- Original-Abgleich: Die Dateien des Shopware-Kerns werden mit dem Original der installierten Version verglichen.
- Datenbank: Skripte in Produkttexten, Textbausteinen und Einstellungen.
- Zugänge: Administratoren, Integrationen, Zugangsschlüssel und Zahlungsarten.
- Einstellungen: Domains, Zahlungsarten, Mailer, Tracking, Webhooks, Flows und Rollen mit Vorher und Jetzt.
- Konfiguration: Umgebung, Debug-Modus und geheime Schlüssel.
- Passwörter und Schlüssel: schwache und alte Passwörter, ungenutzte Schlüssel, Administratoren ohne zweiten Faktor.
- Updates und Lücken: Sicherheitsmeldungen zu Shopware, PHP und Paketen, verfügbare Plugin-Updates.
- Blick von außen: offen erreichbare Dateien, Kopfzeilen, Zertifikat, SPF und DMARC.
- Storefront: Skripte und Formulare, die auf fremde Adressen zeigen.
- Anmeldungen: viele Fehlversuche, Anmeldung aus einem neuen Netz.
- Missbrauch: Häufungen bei Zahlungen, Registrierungen, Passwort-Anfragen und Bestellungen.

## Dateien ansehen, vergleichen und in Quarantäne legen

Bei Funden zu Dateien bieten die Details diese Werkzeuge:
- Datei ansehen: zeigt den Inhalt, verdächtige Stellen sind markiert.
- Mit Original vergleichen: stellt eine Datei des Shopware-Kerns dem Original gegenüber und zeigt die geänderten Zeilen.
- Original zurückspielen: ersetzt eine veränderte Kern-Datei durch das Original der installierten Version. Die bisherige Version landet als Kopie in der Quarantäne.
- In Quarantäne verschieben: verschiebt die Datei aus dem Shop in einen geschützten Ordner. In der Übersicht lässt sie sich wiederherstellen oder endgültig löschen.

Dateien unter vendor, config und bin lassen sich nicht in Quarantäne legen, damit der Shop nicht ausfällt. Hier hilft das Zurückspielen des Originals.

## Sofortmaßnahmen

Bei Funden zu Zugängen stehen die passenden Maßnahmen direkt im Fund: Benutzer sperren meldet den Benutzer überall ab und deaktiviert ihn, Integration sperren entzieht den Zugang, Zahlungsart deaktivieren nimmt sie aus dem Checkout. Den eigenen Benutzer kannst du nicht sperren.

## Sicherheits-Kopfzeilen setzen

Meldet der Blick von außen fehlende Kopfzeilen, bietet der Fund den Knopf Kopfzeilen jetzt setzen. Dasselbe erreichst du unter Einstellungen, Schutz der Storefront. Das Plugin ergänzt bei jeder Seite nur, was fehlt: Schutz vor falscher Typ-Erkennung, Schutz vor Einbettung in fremde Seiten, eine Referrer-Richtlinie und über https die Vorgabe, den Shop nur verschlüsselt aufzurufen. Was Shopware oder der Server schon setzt, bleibt unberührt.

## KI-Einschätzung

Unter Einstellungen, KI-Schnittstelle hinterlegst du Anbieter, Schlüssel und Modell und prüfst die Verbindung mit Verbindung testen. Danach gibt es in den Details eines Funds den Knopf KI-Einschätzung. Die KI bewertet den Fund als unbedenklich, prüfenswert oder kritisch und nennt Schritte. Die Einschätzung ist eine zweite Meinung, keine Entscheidung.
Gesendet werden nur die Angaben des einen Funds und bei Dateien ein Ausschnitt. Ist der KI Produktberater installiert, wird dessen Schlüssel mitgenutzt.

## Zwei-Faktor-Anmeldung einrichten

- Im Reiter Anmeldeschutz beim Benutzer auf Einrichten klicken.
- Den QR-Code mit einer Authenticator-App scannen, zum Beispiel Google Authenticator, Microsoft Authenticator oder 1Password.
- Den sechsstelligen Code aus der App eingeben und bestätigen.
- Die acht Wiederherstellungs-Codes sicher ablegen. Jeder gilt einmal.

Ab dann fragt die Anmeldeseite der Administration nach Benutzername und Passwort den Code ab. Geprüft wird erst das Passwort, dann der Code. Nach fünf falschen Codes ist die Anmeldung für 15 Minuten gesperrt. Integrationen mit API-Schlüssel melden sich weiterhin ohne Code an.

## Anmeldung nur von erlaubten Adressen

Unter Einstellungen, Anmeldungen schaltest du Anmeldung nur von erlaubten Adressen ein und trägst je Zeile eine IP-Adresse oder ein Netz ein, zum Beispiel 203.0.113.10 oder 203.0.113.0/24. IPv6 wird unterstützt.
Beim Speichern prüft das Plugin, ob deine aktuelle Adresse in der Liste steht. Wenn nicht, wird nicht gespeichert. Eine eingeschaltete, aber leere Liste sperrt niemanden.

## Anmeldung nur aus erlaubten Ländern

Unter Einstellungen, Anmeldungen schaltest du Anmeldung nach Ländern einschränken ein, wählst die Art (nur diese Länder erlauben oder diese Länder sperren) und fügst die Länder hinzu. Die Sperre gilt nur für die Anmeldung an der Administration mit Benutzername und Passwort, nicht für die Storefront und nicht für Integrationen.
Beim Speichern prüft das Plugin, ob dein eigenes Land weiter erlaubt wäre. Eine Adresse aus der Liste erlaubter Adressen darf sich unabhängig vom Land anmelden.
Die Zuordnung von Adressen zu Ländern stammt von DB-IP (db-ip.com, Lizenz CC BY 4.0). Das Plugin lädt die Daten einmal im Monat auf deinen Server und schlägt dort nach. Sie ist nicht in jedem Fall genau: VPN und Mobilfunk im Ausland können abweichen. Hinter einem Proxy oder CDN muss Shopware die echte Adresse des Besuchers kennen, der Reiter Anmeldeschutz weist darauf hin.

## Wenn sich niemand mehr anmelden kann

Auf dem Server im Shop-Verzeichnis hebt dieser Befehl den zweiten Faktor für alle Benutzer auf und schaltet Adressliste und Länder-Sperre ab:
bin/console staw:security:login-reset
Mit einem Benutzernamen dahinter gilt er nur für diesen Benutzer. Ohne Zugriff auf die Konsole reicht eine leere Datei:
var/staw-security-scan/disable-login-protection
Solange die Datei existiert, sind Code, Adressliste und Länder-Sperre ausgesetzt.

## Anmelde-Protokoll

Das Plugin protokolliert erfolgreiche und fehlgeschlagene Anmeldungen an der Administration mit Benutzer und Adresse. Zehn Fehlversuche von einer Adresse in 15 Minuten und eine Anmeldung aus einem bisher unbekannten Netz werden als Fund gemeldet. Die Einträge werden nach der eingestellten Zahl von Tagen gelöscht.

## Sitzungen und inaktive Administratoren

Der Reiter Anmeldeschutz zeigt je Benutzer die Zahl der offenen Sitzungen. Überall abmelden beendet alle Sitzungen dieses Benutzers, zum Beispiel nach einem verlorenen Gerät.
Ein Administrator, der sich länger als die eingestellte Zahl von Tagen nicht angemeldet hat, wird als Fund gemeldet. Gezählt wird ab dem Zeitpunkt, seit dem das Plugin Anmeldungen beobachtet. Die Vorgabe sind 180 Tage, 0 schaltet die Meldung ab.

## Passwörter mit Datenlecks abgleichen

Ist Neue Passwörter mit Datenlecks abgleichen eingeschaltet, prüft das Plugin jedes neu gesetzte Admin-Passwort gegen die Sammlung bekannter Datenlecks von Have I Been Pwned. Übertragen werden die ersten fünf Zeichen einer Prüfsumme des Passworts, der Vergleich selbst findet auf deinem Server statt. Das Passwort und die vollständige Prüfsumme verlassen den Server nicht.
Taucht das Passwort in einem Datenleck auf, entsteht ein Fund der Stufe Hoch. Er schließt sich, sobald der Benutzer ein anderes Passwort setzt. Die Vorgabe ist aus, weil ein fremder Dienst beteiligt ist.

## Änderungsprotokoll

Der Reiter Protokoll zeigt, wer wann was geändert hat: Benutzer, Rollen, Integrationen, Zahlungs- und Versandarten, Domains, Flows, Webhooks, Plugins und Einstellungen. Jeder Eintrag nennt Zeit, Benutzer oder Integration, Adresse, den betroffenen Eintrag und die Namen der geänderten Felder. Die Inhalte der Felder werden nicht gespeichert.
Die Einträge werden nach der eingestellten Zahl von Tagen gelöscht, die Vorgabe sind 90 Tage. Unter Einstellungen, Anmeldungen lässt sich das Protokoll abschalten.

## Fallen für Angreifer

Automatische Angriffswerkzeuge suchen nach Seiten, die es in einem Shopware-Shop nicht gibt, etwa /wp-admin oder /phpmyadmin. Mit eingeschalteten Fallen sperrt das Plugin eine solche Adresse für die eingestellte Zeit, die Vorgabe sind 60 Minuten. Der Reiter Anmeldeschutz listet die gesperrten Adressen und hebt eine Sperre auf Wunsch auf.
Die Fallen greifen bei Adressen, die der Webserver an Shopware weiterreicht. Aufrufe von .php-Dateien oder Dateien wie /.env beantwortet auf vielen Servern der Webserver selbst, sie erreichen das Plugin dann nicht. Hinter einem Proxy oder CDN muss Shopware die echte Adresse des Besuchers kennen, sonst träfe die Sperre den Proxy.

## Content Security Policy für die Storefront

Eine Content Security Policy sagt dem Browser, von welchen Adressen er Skripte laden darf. Ein eingeschleuster Skimmer von einer fremden Adresse wird dann nicht ausgeführt.
- Nur melden: Der Browser lädt weiter alles, meldet aber jede Adresse außerhalb der Liste. Die Übersicht zeigt die gemeldeten Adressen.
- Adressen, die zum Shop gehören, unter Erlaubte Adressen eintragen.
- Scharf: Erst wenn keine berechtigten Adressen mehr gemeldet werden.

Die Vorgabe ist Aus. Teste den Checkout mit allen Zahlungsarten, bevor du scharf schaltest.

## Benachrichtigungen und Berichte

Nach jeder Prüfung meldet das Plugin neue Funde ab der gewählten Stufe per E-Mail, mit den Schritten zur Behebung. Jeder Fund wird einmal gemeldet. Ist Behobene Funde melden eingeschaltet, nennt der nächste Bericht auch, was seit dem letzten Mal behoben wurde.
Zusätzlich lässt sich ein Webhook eintragen, etwa für Slack oder Microsoft Teams, und ein Wochenbericht mit dem Stand aller offenen Funde. Beides prüfst du mit einer Testnachricht.
Der PDF-Bericht in der Übersicht fasst Kennzahl, Verlauf, offene Funde mit Schritten und die letzten Prüfungen zusammen. Unter Einstellungen, Bericht per E-Mail hinterlegst du einen eigenen Absendernamen und ein eigenes Logo, zum Beispiel als Agentur für deine Kunden. Zeiten stehen in der Zeitzone des Benutzers.

## Zeitplan, Betrieb ohne Cronjob und Sofort-Meldung

Die volle Prüfung läuft nach Zeitplan über die geplanten Aufgaben von Shopware, standardmäßig täglich um 3 Uhr. Am zuverlässigsten ist ein Cronjob auf dem Server, der die geplanten Aufgaben und die Nachrichten-Warteschlange ausführt.
Prüfung ohne Cronjob: Starten die geplanten Aufgaben die Prüfung nicht, führt das Plugin sie selbst aus. Das beginnt frühestens drei Stunden nach dem fälligen Zeitpunkt, sobald jemand den Shop oder die Administration aufruft, und läuft in kurzen Abschnitten nach der Auslieferung der Seite. Die eingestellte Uhrzeit gilt dabei nicht. Die Übersicht weist darauf hin, und in der Liste der Prüfungen steht Ohne Cronjob. Unter Einstellungen, Zeitplan lässt sich das abschalten.
Selbstüberwachung: Läuft trotzdem zwei Tage keine Prüfung, etwa weil der Shop keine Besucher hat, warnt die Übersicht und einmalig eine E-Mail.
Die Sofort-Meldung reagiert auf kritische Änderungen: neue Administratoren, Integrationen, Plugins und geänderte Zahlungsarten werden Sekunden später geprüft und gemeldet.

## Datenschutz: was gespeichert wird und was nach außen geht

Alle Daten liegen in der Datenbank und im Verzeichnis var/staw-security-scan deines Shops. Personenbezogen sind dabei vor allem IP-Adressen und Benutzernamen von Administratoren:
- Anmelde-Protokoll: Benutzername, IP-Adresse, Zeit, Erfolg und Browser-Kennung jeder Anmeldung an der Administration. Löschung nach 30 Tagen, einstellbar, abschaltbar.
- Änderungsprotokoll: Zeit, Benutzer oder Integration, IP-Adresse, betroffener Eintrag und Namen der geänderten Felder. Löschung nach 90 Tagen, einstellbar, abschaltbar.
- Fallen: die IP-Adresse eines gesperrten Besuchers für die Dauer der Sperre, Vorgabe 60 Minuten. Ab Werk aus.
- Zwei-Faktor-Anmeldung: je Benutzer das Geheimnis für die Codes, die Prüfsummen der Wiederherstellungs-Codes und die Netze, aus denen er sich zuletzt angemeldet hat.
- Funde: können Benutzernamen und IP-Adressen enthalten, etwa bei vielen Fehlversuchen. Kunden der Storefront erfasst das Plugin nicht einzeln, die Missbrauchs-Prüfung zählt nur Häufungen.

Nach außen gehen nur diese Abrufe:
- packagist.org: die Namen der öffentlichen Pakete für den Abgleich mit Sicherheitsmeldungen. Private Pakete werden nicht genannt.
- GitHub: Prüfsummen und Originale des Shopware-Kerns.
- db-ip.com: einmal im Monat die Länderdaten, nur bei eingeschalteter Länder-Sperre. Nachgeschlagen wird auf deinem Server, keine IP-Adresse wird übertragen.
- Have I Been Pwned: die ersten fünf Zeichen einer Prüfsumme neuer Admin-Passwörter, nur wenn der Abgleich eingeschaltet ist.
- KI-Anbieter: Angaben eines Funds und bei Dateien ein Ausschnitt, nur wenn eingerichtet und nur beim Klick auf KI-Einschätzung.
- Webhook: Titel und Ziel neuer Funde an die von dir eingetragene Adresse.
- Deine eigenen Domains: für den Blick von außen und die Prüfung der Storefront.

Rechtsgrundlage: Die Protokolle dienen der Sicherheit des Shops, das ist in der Regel ein berechtigtes Interesse nach Art. 6 Abs. 1 lit. f DSGVO. Betroffen sind Administratoren und bei den Fallen auch Besucher. Nimm die Verarbeitung in dein Verzeichnis der Verarbeitungstätigkeiten auf.
Textvorschlag für die Datenschutzerklärung, wenn die Fallen eingeschaltet sind:
Zum Schutz unseres Shops vor automatisierten Angriffen erkennen wir Aufrufe, die gezielt nach Schwachstellen suchen. In diesem Fall speichern wir die IP-Adresse des Aufrufers für bis zu 60 Minuten und sperren den Zugriff für diese Zeit. Rechtsgrundlage ist unser berechtigtes Interesse an der Sicherheit unseres Angebots (Art. 6 Abs. 1 lit. f DSGVO). Eine Weitergabe an Dritte findet nicht statt.
Für Administratoren genügt meist ein Hinweis in der internen Dokumentation oder im Vertrag mit der Agentur. Der Text ist ein Vorschlag und keine Rechtsberatung, passe die Dauer an deine Einstellung an.

## Grenzen der Prüfung

Der Scanner läuft im Shop selbst. Ein Angreifer mit vollem Zugriff auf den Server kann ihn abschalten oder umgehen. Er ersetzt keine Firewall, keine Updates und keine Sicherungen. Schadcode, der keinem bekannten Muster folgt und vor der ersten Prüfung vorhanden war, kann unentdeckt bleiben, sofern er nicht im Shopware-Kern liegt.

## Rechte im Admin

Das Plugin ist für Benutzer sichtbar, die Erweiterungen verwalten dürfen. Die Zwei-Faktor-Anmeldung richtet ein solcher Benutzer für sich und für andere ein.

## Deinstallation

Beim Deinstallieren mit der Option, alle Daten zu löschen, entfernt das Plugin seine Tabellen und Einstellungen, auch Anmelde- und Änderungsprotokoll. Zweiter Faktor, Adressliste und Länder-Sperre entfallen damit für alle Benutzer. Nur Dateien in der Quarantäne bleiben unter var/staw-security-scan/quarantine liegen und können von Hand gelöscht werden.

## Support

Fragen, Fehler oder Wünsche: Über Feature anfragen im Plugin oder das Kontaktformular erreichst du uns direkt.

