Zusätzliche Kundeninformationen (IP-Sperre): Einrichtung und Hilfe
Schnellstart
- Laden Sie die Modul-ZIP unter "Modules > Module Manager" hoch und öffnen Sie "Configure".
- Aktivieren Sie "Enable Data Collection" und wählen Sie "Track Guest Visitors".
- Wählen Sie "Show Info on Orders", legen Sie "Default Ban Message" fest und speichern Sie.
- Melden Sie sich als Testkunde an und prüfen Sie die erfassten Informationen im Backoffice.
- Fügen Sie Ihre vertrauenswürdige IP unter IP-Whitelist hinzu.
- Fügen Sie unter Gesperrte IPs eine kontrollierte Testregel mit Sperrtyp, Aktiv und optional einem zukünftigen Ablaufdatum hinzu.
- Prüfen Sie die beabsichtigte 403-Antwort und deaktivieren oder entfernen Sie anschließend die Testregel.
Erfordert PrestaShop 1.6.1 oder höher und PHP 7.1 oder höher.
Einrichtungsanleitung
Installation und Erfassung konfigurieren
- Laden Sie Customer Extra Info (IP Ban) unter "Modules > Module Manager" hoch.
- Öffnen Sie "Configure", um zu Einstellungen zu gelangen.
- Prüfen Sie die Schalter für Erfassung und Bestellpanel und speichern Sie.
- Melden Sie sich im Shop als Testkunde an. Warten Sie auf die Erfassungsanfrage und prüfen Sie den Kunden anschließend im Backoffice.
- Fügen Sie vertrauenswürdige Adressen unter IP-Whitelist hinzu, bevor Sie eine Sperre unter Gesperrte IPs testen.
Erfordert PrestaShop 1.6.1 oder höher und PHP 7.1 oder höher.
Einstellungen
| Einstellung | Standard bei Installation | Funktion |
|---|---|---|
| "Enable Data Collection" | Ja | Erfasst technische Besucherinformationen über Shop-, Anmelde- und Kontoerstellungs-Hooks. Ausschalten, um die Erfassung zu stoppen. |
| "Track Guest Visitors" | Ja | Erlaubt die Erfassung nicht angemeldeter Besucher. Ordnet eine Gast-ID zu, sofern verfügbar. |
| "Enable IP Banning" | Ja | Wendet gespeicherte aktive Sperrregeln auf Shop-Anfragen an. Ausschalten, um die Durchsetzung ohne Löschen der Regeln auszusetzen. |
| "Show Info on Orders" | Ja | Fügt das Panel für technische Kundeninformationen auf unterstützten Bestellseiten im Backoffice hinzu. |
| "Default Ban Message" | Ihr Zugang wurde eingeschränkt. Kontaktieren Sie den Administrator, wenn dies ein Fehler ist. | Legen Sie die mehrsprachige Standardnachricht für Besucher fest. Eine Regel kann sie ersetzen. |
Das Modul installiert außerdem TRACK_OS, TRACK_BROWSER, TRACK_SCREEN und TRACK_USERAGENT als 1. Der Collector liest sie, aber das aktuelle Formular Einstellungen bietet keine Bedienelemente dafür. Sie steuern die Speicherung von Betriebssystem, Browser/Version, Bildschirm und unverarbeitetem User-Agent. Sie unterdrücken nicht die Erfassung von IP, Land oder Gerätetyp.
Kundeninformationen prüfen
Das Kundenpanel zeigt die zuletzt erfasste IP, Land, Betriebssystem, Browser/Version, Bildschirmabmessungen, Gerätetyp und Erfassungsdatum sowie den gespeicherten IP-Verlauf. Wenn "Show Info on Orders" aktiviert ist, verwendet das Bestellpanel den Kundendatensatz der Bestellung.
Der Browser-Collector lädt über displayHeader und ruft den Modul-Controller collect etwa 1,5 Sekunden nach Bereitschaft der Seite auf. Er sendet die Abmessungen von window.screen, nicht die des Viewports. Bei funktionierendem sessionStorage merkt er sich eine gesendete Anfrage einmal pro Browser-Tab-Sitzung. Ist der Speicher nicht verfügbar, kann er auf späteren Seiten erneut anfragen.
Die serverseitige Erfassung läuft auch nach erfolgreicher Kundenanmeldung und Erstellung eines neuen Kontos. Sie verhindert innerhalb einer Stunde eine neue Zeile für dieselbe IP und denselben Kunden oder Gast. Eine spätere Bildschirmanfrage kann fehlende Abmessungen in einer vorhandenen aktuellen Zeile ergänzen. Diese Datumsangaben bilden keinen kontinuierlichen Verlauf der Live-Anwesenheit.
Die Ländererkennung versucht zuerst den Länder-Header von Cloudflare, dann verfügbare PrestaShop-GeoIP-Unterstützung und zuletzt das Länder-Cookie. Sie kann ohne Land bleiben. Länderregeln hängen von diesen Werten ab.
Whitelist-Einträge hinzufügen
Öffnen Sie IP-Whitelist und fügen Sie Ihre vertrauenswürdige Adresse oder Ihr Netzwerk hinzu:
| Feld | Wert eines neuen Eintrags | Ihre Aufgabe |
|---|---|---|
| IP-Adresse | Leer | Geben Sie eine genaue IP, ein Platzhaltermuster oder einen unterstützten IPv4-Bereich ein. |
| CIDR-Bereich | Leer | Geben Sie ein IPv4-Subnetz wie 203.0.113.0/24 ein. |
| Bezeichnung | Leer | Fügen Sie eine interne Notiz wie Büro-IP oder Entwickler-VPN hinzu. |
Beispiele sind die genaue Adresse 203.0.113.10, der Platzhalter 203.0.113.* und CIDR 203.0.113.0/24. Whitelist und Sperren verwenden denselben IP-Abgleich. Der Whitelist-Abgleich läuft vor dem Sperrabgleich und hat auch Vorrang vor Länder- und User-Agent-Regeln.
Datensätze speichern den Shop-Kontext. Whitelist-Prüfungen im Multishop berücksichtigen den aktuellen Shop und Einträge mit Shop-ID 0. Sperrregeln mit positiver Shop-ID gelten nur für diesen Shop; 0 bedeutet alle Shops.
Sperrregel hinzufügen
Öffnen Sie Gesperrte IPs, fügen Sie eine Regel hinzu und füllen Sie für den ersten Test ein Abgleichkriterium aus.
| Feld | Wert eines neuen Eintrags | Ihre Aufgabe |
|---|---|---|
| IP-Adresse | Leer | Geben Sie eine genaue Adresse, einen Platzhalter wie 192.0.2.* oder einen IPv4-Bereich wie 198.51.100.10-198.51.100.200 ein. |
| CIDR-Bereich | Leer | Geben Sie ein IPv4-Subnetz wie 192.0.2.0/24 ein. |
| Land | Leer | Wählen Sie einen zweistelligen Ländercode zum Abgleich mit dem erkannten Land. |
| User-Agent-Muster | Leer | Verwenden Sie einfachen Text ohne Beachtung der Großschreibung, etwa BadBot, oder einen durch Schrägstriche begrenzten Regex wie /BadBot|Scraper/. |
| Sperrtyp | Vollständige Sperre - Gesamter Shop (full) |
Wählen Sie Nur Kasse (checkout) oder Nur Anmeldung/Authentifizierung (auth), um den Wirkungsbereich einzugrenzen. |
| Grund | Leer | Fügen Sie eine interne Notiz hinzu. Sie ist nicht die Besuchernachricht. |
| Benutzerdefinierte Sperrnachricht | Leer | Ersetzen Sie "Default Ban Message" für diese Regel. |
| Aktiv | Ja | Ausschalten, um die Regel ohne Durchsetzung zu behalten. |
| Ablaufdatum | Leer | Legen Sie für eine zeitweilige Sperre ein zukünftiges Datum mit Uhrzeit fest oder lassen Sie das Feld für eine unbefristete Sperre leer. |
Die gespeicherten Werte sind full, checkout und auth. Mehrere Abgleichkriterien in einer Regel gelten als alternative Treffer. Der Besucher muss nicht alle Felder erfüllen.
Vollständige Sperren gelten überall im Frontoffice. Der Kassenbereich gleicht die Controller-Namen order, orderopc, cart, supercheckout, onepagecheckout und checkout ab. Der Kontobereich gleicht authentication, my-account, identity, registration und password ab. Der Bereich richtet sich nach dem angeforderten Seiten-Controller; eigene Checkout- oder Kontorouten müssen die passenden Controller-Namen verwenden.
Eine passende Regel liefert HTTP 403 Forbidden mit der Seite Zugriff eingeschränkt. Es gibt keine Weiterleitung. Abgelaufene aktive Sperren werden bei einer späteren Sperrprüfung deaktiviert, nicht durch einen erforderlichen Cronjob.
Regeln prüfen und verwalten
Testen Sie von einer Adresse unter Ihrer Kontrolle, während Ihre eigene vertrauenswürdige Verbindung auf der Whitelist bleibt. Prüfen Sie, dass eine vollständige Sperre das Browsen blockiert, eine Kassensperre die erwarteten Kassen-Controller betrifft und eine inaktive oder abgelaufene Regel diese Anfrage nicht mehr blockiert. Prüfen Sie, dass Anfragen auf der Whitelist passieren.
Die Verwaltungslisten unterstützen Filter, Bearbeiten/Löschen und Export. Die Sperrliste bietet gesammeltes Aktivieren/Deaktivieren. Prüfen Sie den Mitarbeiterzugriff auf diese Modulseiten über PrestaShop-Mitarbeiterprofile.
Verwenden Sie für einen zeitweiligen Kassentest einen IPv4-Bereich, Sperrtyp checkout, Aktiv Ja und einen zukünftigen Ablauf. Ein Datum vor dem Testzeitpunkt deaktiviert die Regel.
Fehler beheben und anpassen
- Wenn eine Sperre nicht greift, prüfen Sie zuerst "Enable IP Banning", Aktiv, Ablauf, Bereich, Shop und Whitelist-Treffer.
- Prüfen Sie die vom Shop erkannte IP und das Land, besonders hinter einem Proxy. Der Browserstandort oder Ihre erwartete öffentliche IP kann von den Anfragedaten des Moduls abweichen.
- IPv4-Bereiche und CIDR verwenden
ip2long. Verwenden Sie für IPv6 genaue Übereinstimmungen; das Modul implementiert keinen IPv6-Subnetzabgleich. - Regex-Abgleich läuft nur, wenn das erste und letzte Zeichen
/ist. Ein Muster mit Flags nach dem schließenden Schrägstrich wird nach dieser Erkennungsregel als einfacher Text behandelt. - Wenn Bildschirmdaten des Kunden fehlen, prüfen Sie die verzögerte collect-Anfrage und JavaScript-Fehler. Eine blockierte Anfrage oder ein bereits gesetztes sessionStorage-Flag kann eine neue Anfrage verhindern.
- Wenn ein Bestellpanel fehlt, prüfen Sie "Show Info on Orders" und die Hook-Unterstützung der Verwaltungsseite. Der Erfassungsverlauf beginnt mit Aktivierung der Erfassung; ein Import historischer Gerätedaten ist nicht vorhanden.
Das Modul verwendet displayHeader, actionFrontControllerInitBefore, displayAdminCustomers, displayAdminOrder, displayBackOfficeHeader, actionAuthentication und actionCustomerAccountAdd. Stylesheet-Anpassungen für Theme und Backoffice können .mprceiipban-panel, dessen .panel-heading, .badge und Tabellenzellen ansprechen.
Deaktivieren oder deinstallieren
Schalten Sie "Enable Data Collection" und "Enable IP Banning" getrennt aus, um diese Aktionen auszusetzen. Die Deinstallation über "Module Manager" entfernt Modulkonfiguration, Verwaltungseinträge und Modulschema, einschließlich erfasster Informationen, Sperren und Whitelist-Datensätzen. Sichern Sie diese Datensätze vorher, falls Sie sie später benötigen.
Fragen
Noch keine Fragen zu diesem Modul
Fragen Sie alles zu Installation, Kompatibilität oder Einrichtung. Die Antworten erscheinen hier.
Bekannte Probleme
11
IPv6-Adressen werden von IP-Bereichs-Sperrregeln nicht erfasst
Sperrregeln mit CIDR-Notation (z. B. 2001:db8::/32) werden ignoriert, weil die Vergleichsfunktion nur IPv4-Bereiche verarbeitet.
Hinweis zur Lösung
IPv6-CIDR-Matching mit PHPs inet_pton() für IPv4- und IPv6-Adressvergleiche hinzugefügt.
Sperrregeln für einzelne IP-Adressen nicht speicherbar
„Speichern und bleiben“ übersprang Prüfung oder verließ Seite
Verwaltungsbeschriftungen blieben auf Englisch
Modul ließ sich unter PHP 7.1 nicht laden
Verbesserte Sicherheit
Modulklassen wurden nicht geladen
Beschädigte Modulübersetzungen
Bestehende Moduleinstellungen fehlerhaft migriert
Verwaltungsfehler mit gemeinsamen Komponenten
Verwaltungslistenfilter unzuverlässig
Funktionsanfragen
4
Implementiert
IPv4-Subnetze mit CIDR-Notation sperren
Mehrsprachige Verwaltung
Updates mit einem Klick
Abstimmung der Schutzmodule
Änderungsprotokoll
v2.0.62026-07-15
- Addedcomplete FR/DE/ES/IT/PL translations
- FixedMigrate module state to MPR config
Ältere Versionen
v3.4.02026-04-20
- Addedadmin menu management via MenuInstaller for streamlined module setup
- AddedLicense management tab with key management and renewal options
- Addedself-healing integrity checks for automatic diagnostics and repair
- Addedcomplete FR/DE/ES/IT/PL translations
- Improvedadmin list columns with visual badge indicators and multiselect filters
- Fixedadmin list filters — sorting, searching, and filtering now work correctly on all columns
v3.3.12026-02-14
- AddedPrestaShop 9 and Hummingbird theme compatibility
- FixedIP ban check not triggering on PS 9 when checkout uses the new Address controller route
- Improvedsuspicious activity detection heuristics for headless browser and scripted fingerprints
- Fixedback-office customer detail panel throwing a notice when customer has zero orders
v3.3.02025-11-27
- AddedCIDR range support for IP bans enabling blocking of entire subnets (e.g. /24)
- Addedautomatic temporary ban after configurable number of consecutive failed login attempts
- Improvedban reason tooltip in back-office customer list for at-a-glance context
- Fixedban not enforced on account registration when PS guest checkout is disabled
v3.2.12025-09-14
- FixedPHP 8.3 deprecation notice in browser fingerprint user-agent parser
- ImprovedIPv6 address normalization to prevent ban bypass via abbreviated notation
v3.2.02025-07-31
- Addedconfigurable ban duration: permanent, temporary with hours/days, or session-only
- Addedexport of full IP ban list to CSV for compliance archiving
- Improveddetection of VPN and proxy IP addresses via configurable ASN blocklist
- Fixedsession info panel not displaying on PS 1.7.8 back-office customer edit page
v3.1.02025-05-19
- Addedcustomer technical details panel in back office showing OS, browser, screen resolution, and language
- Addedban history log recording administrator name, timestamp, and reason for each action
- ImprovedIP display with country flag and ISP name alongside the IP address
- Fixedcustomer detail panel failing to load when PS back-office lazy load is active
v3.0.12025-03-12
- FixedIP resolution failing behind Nginx reverse proxy when X-Forwarded-For header is not normalized
- Improvedmultistore compatibility: bans can be applied shop-wide or scoped to a single shop
v3.0.02025-01-08
- Redesigned ban management interface with dedicated IP ban list and full-text search
- Addedone-click ban from customer list, order detail, and guest checkout views
- Addedcustomizable ban message displayed to blocked visitors
- Migrated module database schema to natively support IPv6 addresses
- Addedsuspicious activity flag on customer record with configurable alert thresholds
Demo
Testen Sie das vollständige Modul vor dem Kauf
Kaufen Sie die Lizenz später, Ihre Einstellungen bleiben erhalten.
- Ihre 30-Tage-Demo Testen Sie es 30 Tage ab der ersten Installation in Ihrem eigenen Shop.
- Fertiger Demo-Shop Entdecken Sie einen fertigen Demo-Shop im Browser.
- Ohne Registrierung Kein Konto, keine E-Mail-Adresse und keine Shop-Domain nötig.
Mit dem Download akzeptieren Sie die Demo-Bedingungen und die Datenschutzerklärung.
Mit dem Öffnen dieser Demo akzeptieren Sie die Demo-Nutzungsbedingungen und die Datenschutzerklärung.