Informazioni aggiuntive sul cliente (blocco IP): configurazione e aiuto

Avvio rapido

  1. Carica lo ZIP del modulo in "Modules > Module Manager" e apri "Configure".
  2. Attiva "Enable Data Collection" e scegli "Track Guest Visitors".
  3. Scegli "Show Info on Orders", imposta "Default Ban Message" e salva.
  4. Accedi come cliente di prova e verifica le informazioni raccolte nel back office.
  5. Aggiungi il tuo IP attendibile in Whitelist IP.
  6. Aggiungi una regola di prova controllata in IP bloccati con Tipo di blocco, Attivo e un'eventuale Data di scadenza futura.
  7. Verifica la risposta 403 prevista, poi disattiva o rimuovi la regola di prova.

Richiede PrestaShop 1.6.1 o successivo e PHP 7.1 o successivo.

Manuale di configurazione

Installa e configura la raccolta

  1. Carica Customer Extra Info (IP Ban) in "Modules > Module Manager".
  2. Apri "Configure" per accedere a Impostazioni.
  3. Controlla gli interruttori della raccolta e del pannello ordini, poi salva.
  4. Accedi al negozio come cliente di prova. Attendi la richiesta del collettore, poi controlla il cliente nel back office.
  5. Aggiungi gli indirizzi attendibili in Whitelist IP prima di provare un blocco in IP bloccati.

Richiede PrestaShop 1.6.1 o successivo e PHP 7.1 o successivo.

Impostazioni

Impostazione Valore all'installazione Cosa fa
"Enable Data Collection" Sì Raccoglie informazioni tecniche dei visitatori tramite gli hook del negozio, dell'accesso e della creazione account. Disattiva per interrompere la raccolta.
"Track Guest Visitors" Sì Permette la raccolta per i visitatori non connessi. Associa un ID ospite quando disponibile.
"Enable IP Banning" Sì Applica le regole di blocco attive salvate alle richieste del negozio. Disattiva per sospenderne l'applicazione senza eliminarle.
"Show Info on Orders" Sì Aggiunge il pannello delle informazioni tecniche cliente nelle pagine amministrative degli ordini supportate.
"Default Ban Message" Il tuo accesso è stato limitato. Contatta l'amministratore se ritieni sia un errore. Imposta il messaggio multilingue predefinito per il visitatore. Una regola può sostituirlo.

Il modulo installa anche TRACK_OS, TRACK_BROWSER, TRACK_SCREEN e TRACK_USERAGENT a 1. Il collettore li legge, ma il form di configurazione attuale non offre controlli dedicati. Regolano il salvataggio di sistema operativo, browser/versione, schermo e user-agent grezzo. Non impediscono la raccolta di IP, paese o tipo di dispositivo.

Controlla le informazioni cliente

Il pannello cliente mostra gli ultimi dati raccolti: IP, paese, sistema operativo, browser/versione, dimensioni dello schermo, tipo di dispositivo e data di raccolta, oltre allo storico IP. Quando "Show Info on Orders" è attivo, il pannello ordine usa il record del cliente dell'ordine.

Il collettore del browser viene caricato tramite displayHeader e richiede il controller collect del modulo circa 1,5 secondi dopo che la pagina è pronta. Invia le dimensioni window.screen, non quelle del viewport. Se sessionStorage funziona, memorizza una richiesta inviata una volta per sessione della scheda del browser. Se lo storage non è disponibile può riprovare nelle pagine successive.

La raccolta lato server avviene anche dopo un accesso cliente riuscito e la creazione di un nuovo account. Evita una nuova riga per lo stesso IP e cliente o ospite entro un'ora. Una richiesta successiva dello schermo può completare le dimensioni mancanti in una riga recente esistente. Queste date non sono uno storico continuo della presenza live.

Il rilevamento del paese prova l'header paese di Cloudflare, poi il supporto GeoIP disponibile di PrestaShop, quindi il cookie paese. Può non restituire alcun paese. Le regole per paese dipendono da questi valori.

Aggiungi voci alla whitelist

Apri Whitelist IP e aggiungi il tuo indirizzo o la tua rete attendibile:

Campo Valore nuova voce Cosa fare
Indirizzo IP Vuoto Inserisci un IP esatto, un modello con caratteri jolly o un intervallo IPv4 supportato.
Intervallo CIDR Vuoto Inserisci una sottorete IPv4 come 203.0.113.0/24.
Etichetta Vuoto Aggiungi una nota interna come IP ufficio o VPN sviluppatore.

Esempi: indirizzo esatto 203.0.113.10, jolly 203.0.113.* e CIDR 203.0.113.0/24. La whitelist usa lo stesso sistema di confronto IP dei blocchi. Viene controllata prima dei blocchi e prevale anche sulle regole per paese e user-agent.

I record memorizzano il contesto del negozio. In multinegozio, i controlli whitelist includono il negozio corrente e le voci con ID negozio 0. Le regole di blocco con ID negozio positivo valgono solo per quel negozio; 0 significa tutti i negozi.

Aggiungi una regola di blocco

Apri IP bloccati, aggiungi una regola e compila un solo criterio di corrispondenza per il primo test.

Campo Valore nuova voce Cosa fare
Indirizzo IP Vuoto Inserisci un indirizzo esatto, un jolly come 192.0.2.* o un intervallo IPv4 come 198.51.100.10-198.51.100.200.
Intervallo CIDR Vuoto Inserisci una sottorete IPv4 come 192.0.2.0/24.
Paese Vuoto Seleziona un codice paese di due lettere da confrontare con il paese rilevato.
Pattern User Agent Vuoto Usa testo senza distinzione tra maiuscole e minuscole, come BadBot, o una regex delimitata da barre, come /BadBot|Scraper/.
Tipo di blocco Blocco completo - Intero negozio (full) Scegli Solo checkout (checkout) o Solo accesso/autenticazione (auth) per restringere l'applicazione.
Motivo Vuoto Aggiungi una nota interna. Non è il messaggio per il visitatore.
Messaggio di ban personalizzato Vuoto Sostituisci "Default Ban Message" per questa regola.
Attivo Sì Disattiva per conservare la regola senza applicarla.
Data di scadenza Vuoto Imposta una data/ora futura per un blocco temporaneo o lascia vuoto per nessuna scadenza.

I valori salvati sono full, checkout e auth. Più criteri presenti in una regola funzionano come corrispondenze alternative. Non richiedono che il visitatore corrisponda a ogni campo.

I blocchi completi valgono ovunque nel front office. L'ambito checkout corrisponde ai controller order, orderopc, cart, supercheckout, onepagecheckout e checkout. L'ambito account corrisponde a authentication, my-account, identity, registration e password. L’ambito segue il controller della pagina richiesta; le route personalizzate di checkout o account devono usare i nomi di controller corrispondenti.

Una regola corrispondente restituisce HTTP 403 Forbidden con la pagina Accesso limitato. Non c'è reindirizzamento. I blocchi attivi scaduti vengono disattivati durante un successivo controllo dei blocchi, senza un cron obbligatorio.

Verifica e gestisci le regole

Prova da un indirizzo che controlli mantenendo la tua connessione attendibile in whitelist. Verifica che un blocco completo impedisca la navigazione, che un blocco checkout riguardi i controller previsti e che una regola inattiva o scaduta non blocchi più quella richiesta. Verifica che le richieste in whitelist passino.

Gli elenchi amministrativi supportano filtri, modifica/eliminazione ed esportazione. L'elenco blocchi include attivazione/disattivazione di massa. Controlla l'accesso del personale a queste schermate con i profili dipendenti PrestaShop.

Per un test temporaneo del checkout, usa un intervallo IPv4, Tipo di blocco checkout, Attivo Sì e una scadenza futura. Le date precedenti al momento del test disattivano la regola.

Risolvi i problemi e personalizza

  • Se un blocco non si applica, controlla prima "Enable IP Banning", Attivo, scadenza, ambito, negozio e corrispondenze della whitelist.
  • Controlla IP e paese rilevati dal negozio, soprattutto dietro un proxy. La posizione del browser o il tuo IP pubblico atteso possono differire dai dati della richiesta usati dal modulo.
  • Gli intervalli IPv4 e CIDR usano ip2long. Usa corrispondenze esatte per IPv6; il modulo non implementa il confronto delle sottoreti IPv6.
  • Il confronto regex viene eseguito solo se il primo e l'ultimo carattere sono /. Un modello con flag dopo la barra finale viene trattato come testo semplice da questa regola di rilevamento.
  • Se i dati dello schermo cliente sono vuoti, controlla la richiesta collect ritardata e gli errori JavaScript. Una richiesta bloccata o un flag sessionStorage già impostato possono impedire una nuova richiesta.
  • Se manca il pannello ordine, controlla "Show Info on Orders" e il supporto degli hook nella pagina amministrativa. Lo storico inizia quando attivi la raccolta; non esiste un'importazione di dispositivi storici.

Il modulo usa displayHeader, actionFrontControllerInitBefore, displayAdminCustomers, displayAdminOrder, displayBackOfficeHeader, actionAuthentication e actionCustomerAccountAdd. Le modifiche ai fogli di stile del tema/amministrazione possono usare .mprceiipban-panel, il suo .panel-heading, .badge e le celle delle tabelle.

Disattiva o disinstalla

Disattiva separatamente "Enable Data Collection" e "Enable IP Banning" per sospendere le rispettive azioni. La disinstallazione da "Module Manager" rimuove configurazione, voci amministrative e schema del modulo, inclusi dati raccolti, blocchi e voci whitelist. Salva prima una copia dei record se ti serviranno in seguito.

Domande

Ancora nessuna domanda su questo modulo

Chiedi qualsiasi cosa su installazione, compatibilità o configurazione. Le risposte compaiono qui.

Problemi noti

11

Gli indirizzi IPv6 non vengono riconosciuti dalle regole di ban per intervalli IP

Aperto

Le regole di ban che usano la notazione CIDR (es. 2001:db8::/32) vengono ignorate perché la funzione di confronto gestisce solo intervalli IPv4.

Nota sulla risoluzione

Aggiunto il matching CIDR IPv6 usando inet_pton() di PHP per i confronti di indirizzi sia IPv4 che IPv6.

Regole di blocco per singoli IP non salvabili

RisoltoAggiornato:
Risolto nella versione: 2.0.16
Salvare un blocco per un singolo indirizzo IP poteva fallire senza un intervallo di rete inserito.

Salva e rimani saltava la convalida o lasciava la pagina

RisoltoAggiornato:
Risolto nella versione: 2.0.16
Salva e rimani non convalidava sempre le impostazioni inviate o non manteneva il commerciante sulla pagina corrente.

Etichette dell’amministrazione rimaste in inglese

RisoltoAggiornato:
Risolto nella versione: 2.0.16
Le etichette tradotte dell’amministrazione del modulo potevano ancora apparire in inglese.

Il modulo non si caricava su PHP 7.1

RisoltoAggiornato:
Risolto nella versione: 2.0.12
Il modulo poteva essere rifiutato su PHP 7.1 a causa di requisiti errati nel pacchetto.

Sicurezza rafforzata

RisoltoAggiornato:
Risolto nella versione: 2.0.11
Sicurezza rafforzata.

Caricamento delle classi del modulo non riuscito

RisoltoAggiornato:
Risolto nella versione: 2.0.11
Il modulo poteva non caricare i componenti necessari dopo un aggiornamento.

Traduzioni del modulo danneggiate

RisoltoAggiornato:
Risolto nella versione: 2.0.11
Alcuni testi di amministrazione mostravano traduzioni danneggiate.

Migrazione errata delle impostazioni esistenti del modulo

RisoltoAggiornato:
Risolto nella versione: 2.0.7
La migrazione delle impostazioni del modulo poteva non conservare la configurazione salvata.

Errori di amministrazione con componenti condivisi

RisoltoAggiornato:
Risolto nella versione: 2.0.7
L’amministrazione del modulo poteva fallire se mancava il supporto di compatibilità richiesto o un altro modulo aveva già caricato un componente condiviso.

Filtri degli elenchi di amministrazione inaffidabili

RisoltoAggiornato:
Risolto nella versione: 2.0.6
I filtri degli elenchi di amministrazione potevano ignorare i valori selezionati o restituire risultati errati.

Richieste funzionalità

4

Implementato

Blocco delle sottoreti IPv4 in notazione CIDR

Implementato
Puoi bloccare un'intera sottorete IPv4 usando la notazione CIDR, ad esempio /24. Gli intervalli IPv6 non sono supportati.

Amministrazione multilingue

Implementato
Usa i testi dell'amministrazione del modulo in francese, tedesco, spagnolo, italiano e polacco.

Aggiornamenti con un clic

Implementato
Aggiorna il modulo dalla sua pagina di amministrazione.

Coordinamento dei moduli di protezione

Implementato
Coordina il blocco degli IP con gli altri moduli installati che forniscono protezione firewall.

Registro modifiche

v2.0.62026-07-15

  • Addedcomplete FR/DE/ES/IT/PL translations
  • FixedMigrate module state to MPR config
Versioni precedenti

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

Prova il modulo completo prima di acquistare

Acquista la licenza in seguito e mantieni le tue impostazioni.

  • La tua demo di 30 giorni Provalo sul tuo negozio per 30 giorni dalla prima installazione.
  • Negozio demo pronto Esplora un negozio demo pronto nel tuo browser.
  • Senza registrazione Nessun account, e-mail o dominio del negozio richiesto.
Avvia il negozio demo

Scaricando, accetti le condizioni della demo e l’informativa sulla privacy.

Aprendo questa demo accetti i termini della demo e la politica sulla privacy.

Caricamento...
Torna su