Admin-Kontosperre - Sperren statt löschen

Installation

1. Plugin über den Shopware Store beziehen oder unter Erweiterungen > Meine Erweiterungen als ZIP-Datei hochladen
2. In der Erweiterungsliste auf Installieren klicken — die benötigten Datenbanktabellen werden bei der Installation automatisch angelegt
3. Das Plugin über den Schalter links in der Erweiterungskarte aktivieren
4. Die Administration einmal neu laden, damit die neuen Bereiche erscheinen

Es ist keine weitere Konfiguration nötig — nach der Aktivierung sind alle Funktionen sofort einsatzbereit.

Benutzer sperren

Über die Benutzer-Detailseite (mit Grund, Beginn und Ablauf)

1. Einstellungen > System > Benutzer & Rechte öffnen und in der Benutzerliste den gewünschten Benutzer anklicken
2. Auf der Detailseite zur Karte Kontosperre scrollen
3. Optional einen Sperrgrund eintragen (wird im Banner der Sperre angezeigt)
4. Optional Gesperrt ab setzen: Liegt der Zeitpunkt in der Zukunft, wird die Sperre nur geplant und beginnt automatisch zu diesem Zeitpunkt — bis dahin kann sich der Benutzer normal anmelden
5. Optional Gesperrt bis setzen: Zu diesem Zeitpunkt endet die Sperre automatisch und der Benutzer kann sich wieder anmelden
6. Auf Konto sperren klicken — ohne Datumsangaben wirkt die Sperre sofort und unbefristet

Beide Datumsfelder verwenden die Zeitzone UTC; die Anzeige gesetzter Sperren erfolgt in der Zeitzone des angemeldeten Admin-Benutzers.

Nach dem Sperren zeigt die Karte ein Banner Konto gesperrt mit "Gesperrt seit", "Gesperrt bis" und dem Grund. Bei einer geplanten Sperre erscheint stattdessen das Banner Sperre geplant mit "Gesperrt ab". Zum Aufheben genügt ein Klick auf Konto entsperren.

Schnell sperren über die Benutzerliste

1. In der Benutzerliste das Kontextmenü (drei Punkte) der Zeile öffnen
2. Konto sperren wählen und den Bestätigungsdialog mit Konto sperren bestätigen — diese Schnellsperre wirkt immer sofort und unbefristet
3. Zum Aufheben im Kontextmenü Konto entsperren wählen

Die Benutzerliste zeigt den Status in der Spalte Kontosperre: Gesperrt für wirksame und Geplant für geplante Sperren. Für Sperren mit Grund, Beginn oder Ablauf die Detailseite verwenden.

Was eine Sperre bewirkt

• Der Benutzer kann sich nicht mehr an der Administration anmelden
• Bereits angemeldete Sitzungen des Benutzers werden beim nächsten Aufruf beendet
• Gespeicherte Anmelde-Token werden nicht mehr verlängert
• Der Benutzer kann sich kein neues Passwort über "Passwort vergessen" setzen
• Alle Daten, Zuordnungen und die Historie des Benutzers bleiben vollständig erhalten

Integrationen sperren

1. Einstellungen > System > Integrationen öffnen — die Liste zeigt den Sperrstatus in der Spalte Sperre
2. Entweder im Kontextmenü der Zeile Integration sperren wählen und den Dialog bestätigen (sofort und unbefristet)
3. Oder Integration bearbeiten öffnen: Im Abschnitt Integrationssperre stehen dieselben Felder wie bei Benutzern zur Verfügung (Sperrgrund, Gesperrt ab, Gesperrt bis)

Eine gesperrte Integration erhält keine neuen API-Zugriffs-Token mehr; bereits ausgegebene Token werden beim nächsten Aufruf abgelehnt. Nach dem Entsperren funktioniert der API-Zugang mit den unveränderten Zugangsdaten sofort wieder.

Eingebaute Schutzmechanismen

• Kein Selbst-Aussperren: Das eigene Konto kann nicht gesperrt werden — die Karte zeigt in diesem Fall nur einen Hinweis
• Letzter Administrator: Der letzte aktive, nicht gesperrte Administrator kann nicht gesperrt werden; der Versuch wird mit einer Fehlermeldung abgelehnt. Auch geplante Sperren zählen dabei mit — es kann nie für alle Administratoren gleichzeitig eine Sperre bestehen oder anstehen

Rechte vergeben

1. Einstellungen > System > Benutzer & Rechte öffnen und im Bereich Rollen eine Rolle erstellen oder bearbeiten
2. Im Berechtigungs-Bereich unter der Kategorie Einstellungen die Zeilen Admin-Kontosperren und Admin-Integrationssperren aktivieren:
   • Ansehen — Sperrstatus, Banner und Listen-Badges sehen
   • Bearbeiten — Sperren setzen und aufheben

Benutzer mit Administrator-Rechten benötigen keine gesonderte Freischaltung.

Sperren per Admin-API steuern

Alle Funktionen stehen auch über die Admin-API bereit, z. B. für Offboarding-Automatisierungen:

• POST /api/_action/okuehne-admin-user/{userId}/lock — sperrt einen Benutzer; optionaler JSON-Body mit "reason", "lockedFrom" und "lockedUntil" (ISO-8601)
• POST /api/_action/okuehne-admin-user/{userId}/unlock — hebt die Sperre auf
• GET /api/_action/okuehne-admin-user/{userId}/status — liefert den aktuellen Sperrstatus
• Für Integrationen identisch unter /api/_action/okuehne-admin-integration/{integrationId}/…

Die Endpunkte erfordern ein Admin-API-Token mit den oben beschriebenen Berechtigungen.

Hinweis zu geplanten und befristeten Sperren

Die Sperr-Wirkung selbst ist zeitgenau und benötigt keinen Cron: Beginn und Ablauf werden bei jedem Anmelde- und API-Versuch live geprüft. Für das automatische Aufräumen abgelaufener Sperren und das Entwerten gespeicherter Anmelde-Token geplanter Sperren sollte die Shopware-Warteschlange (Message-Queue und geplante Aufgaben) wie von Shopware empfohlen laufen.

Deinstallation

1. Das Plugin unter Erweiterungen > Meine Erweiterungen über den Schalter deaktivieren
2. Im Kontextmenü Deinstallieren wählen
3. Im Dialog entscheiden: Mit der Option Alle App-Daten endgültig entfernen werden die Sperr-Tabellen gelöscht; ohne diese Option bleiben bestehende Sperren für eine spätere Neuinstallation erhalten

Benutzer und Integrationen selbst werden durch das Plugin niemals verändert oder gelöscht.