Zusätzliche Kundeninformationen (IP-Sperre): Einrichtung und Hilfe

Schnellstart

  1. Laden Sie die Modul-ZIP unter "Modules > Module Manager" hoch und öffnen Sie "Configure".
  2. Aktivieren Sie "Enable Data Collection" und wählen Sie "Track Guest Visitors".
  3. Wählen Sie "Show Info on Orders", legen Sie "Default Ban Message" fest und speichern Sie.
  4. Melden Sie sich als Testkunde an und prüfen Sie die erfassten Informationen im Backoffice.
  5. Fügen Sie Ihre vertrauenswürdige IP unter IP-Whitelist hinzu.
  6. Fügen Sie unter Gesperrte IPs eine kontrollierte Testregel mit Sperrtyp, Aktiv und optional einem zukünftigen Ablaufdatum hinzu.
  7. 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

  1. Laden Sie Customer Extra Info (IP Ban) unter "Modules > Module Manager" hoch.
  2. Öffnen Sie "Configure", um zu Einstellungen zu gelangen.
  3. Prüfen Sie die Schalter für Erfassung und Bestellpanel und speichern Sie.
  4. Melden Sie sich im Shop als Testkunde an. Warten Sie auf die Erfassungsanfrage und prüfen Sie den Kunden anschließend im Backoffice.
  5. 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

Offen

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

GelöstAktualisiert:
Behoben in: 2.0.16
Das Speichern einer Sperre für eine einzelne IP-Adresse konnte ohne Eingabe eines Netzwerkbereichs fehlschlagen.

„Speichern und bleiben“ übersprang Prüfung oder verließ Seite

GelöstAktualisiert:
Behoben in: 2.0.16
„Speichern und bleiben“ prüfte die übermittelten Einstellungen nicht zuverlässig oder hielt den Händler nicht auf der aktuellen Seite.

Verwaltungsbeschriftungen blieben auf Englisch

GelöstAktualisiert:
Behoben in: 2.0.16
Übersetzte Beschriftungen der Modulverwaltung konnten weiterhin auf Englisch erscheinen.

Modul ließ sich unter PHP 7.1 nicht laden

GelöstAktualisiert:
Behoben in: 2.0.12
Das Modul konnte unter PHP 7.1 wegen falscher Paketanforderungen abgelehnt werden.

Verbesserte Sicherheit

GelöstAktualisiert:
Behoben in: 2.0.11
Verbesserte Sicherheit.

Modulklassen wurden nicht geladen

GelöstAktualisiert:
Behoben in: 2.0.11
Das Modul konnte nach einem Update seine erforderlichen Komponenten nicht laden.

Beschädigte Modulübersetzungen

GelöstAktualisiert:
Behoben in: 2.0.11
Einige Verwaltungstexte zeigten beschädigte Übersetzungen an.

Bestehende Moduleinstellungen fehlerhaft migriert

GelöstAktualisiert:
Behoben in: 2.0.7
Bei der Migration der Moduleinstellungen konnte die gespeicherte Konfiguration verloren gehen.

Verwaltungsfehler mit gemeinsamen Komponenten

GelöstAktualisiert:
Behoben in: 2.0.7
Die Modulverwaltung konnte fehlschlagen, wenn erforderliche Kompatibilitätsunterstützung fehlte oder ein anderes Modul bereits eine gemeinsame Komponente geladen hatte.

Verwaltungslistenfilter unzuverlässig

GelöstAktualisiert:
Behoben in: 2.0.6
Verwaltungslistenfilter konnten ausgewählte Werte ignorieren oder falsche Ergebnisse liefern.

Funktionsanfragen

4

Implementiert

IPv4-Subnetze mit CIDR-Notation sperren

Implementiert
IP-Sperren können über die CIDR-Notation ein ganzes IPv4-Subnetz abdecken, etwa /24. IPv6-Bereiche werden nicht unterstützt.

Mehrsprachige Verwaltung

Implementiert
Verwenden Sie Modulverwaltungstexte auf Französisch, Deutsch, Spanisch, Italienisch und Polnisch.

Updates mit einem Klick

Implementiert
Aktualisieren Sie das Modul über seine Verwaltungsseite.

Abstimmung der Schutzmodule

Implementiert
Stimmen Sie die IP-Sperrung mit anderen installierten Modulen ab, die Firewall-Schutz bereitstellen.

Ä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.
Demo-Shop starten

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.

Lade ...
Nach oben