Informazioni aggiuntive sul cliente (blocco IP): configurazione e aiuto
Avvio rapido
- Carica lo ZIP del modulo in "Modules > Module Manager" e apri "Configure".
- Attiva "Enable Data Collection" e scegli "Track Guest Visitors".
- Scegli "Show Info on Orders", imposta "Default Ban Message" e salva.
- Accedi come cliente di prova e verifica le informazioni raccolte nel back office.
- Aggiungi il tuo IP attendibile in Whitelist IP.
- Aggiungi una regola di prova controllata in IP bloccati con Tipo di blocco, Attivo e un'eventuale Data di scadenza futura.
- 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
- Carica Customer Extra Info (IP Ban) in "Modules > Module Manager".
- Apri "Configure" per accedere a Impostazioni.
- Controlla gli interruttori della raccolta e del pannello ordini, poi salva.
- Accedi al negozio come cliente di prova. Attendi la richiesta del collettore, poi controlla il cliente nel back office.
- 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
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
Salva e rimani saltava la convalida o lasciava la pagina
Etichette dell’amministrazione rimaste in inglese
Il modulo non si caricava su PHP 7.1
Sicurezza rafforzata
Caricamento delle classi del modulo non riuscito
Traduzioni del modulo danneggiate
Migrazione errata delle impostazioni esistenti del modulo
Errori di amministrazione con componenti condivisi
Filtri degli elenchi di amministrazione inaffidabili
Richieste funzionalità
4
Implementato
Blocco delle sottoreti IPv4 in notazione CIDR
Amministrazione multilingue
Aggiornamenti con un clic
Coordinamento dei moduli di protezione
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.
Scaricando, accetti le condizioni della demo e l’informativa sulla privacy.
Aprendo questa demo accetti i termini della demo e la politica sulla privacy.