Información adicional del cliente (bloqueo IP): configuración y ayuda
Inicio rápido
- Sube el ZIP del módulo en "Modules > Module Manager" y abre "Configure".
- Activa "Enable Data Collection" y elige "Track Guest Visitors".
- Elige "Show Info on Orders", configura "Default Ban Message" y guarda.
- Inicia sesión como cliente de prueba y verifica la información recopilada en el back office.
- Añade tu IP de confianza en Lista blanca de IP.
- Añade una regla de prueba controlada en IP bloqueadas con Tipo de bloqueo, Activo y una Fecha de caducidad futura opcional.
- Comprueba la respuesta 403 prevista y desactiva o elimina la regla de prueba.
Requiere PrestaShop 1.6.1 o posterior y PHP 7.1 o posterior.
Manual de configuración
Instalar y configurar la recopilación
- Sube Customer Extra Info (IP Ban) en "Modules > Module Manager".
- Abre "Configure" para acceder a Configuración.
- Revisa los interruptores de recopilación y del panel de pedidos, y guarda.
- Inicia sesión en la tienda como cliente de prueba. Espera la solicitud del recopilador y después inspecciona al cliente en el back office.
- Añade direcciones de confianza en Lista blanca de IP antes de probar un bloqueo en IP bloqueadas.
Requiere PrestaShop 1.6.1 o posterior y PHP 7.1 o posterior.
Ajustes
| Ajuste | Valor al instalar | Qué hace |
|---|---|---|
| "Enable Data Collection" | Sí | Recopila información técnica de visitantes mediante hooks de la tienda, inicio de sesión y creación de cuenta. Desactívalo para detener la recopilación. |
| "Track Guest Visitors" | Sí | Permite recopilar datos de visitantes que no han iniciado sesión. Asocia un ID de invitado cuando está disponible. |
| "Enable IP Banning" | Sí | Aplica las reglas de bloqueo activas guardadas a las solicitudes de la tienda. Desactívalo para suspender su aplicación sin borrar las reglas. |
| "Show Info on Orders" | Sí | Añade el panel de información técnica del cliente en las páginas administrativas de pedidos compatibles. |
| "Default Ban Message" | Su acceso ha sido restringido. Contacte al administrador si cree que es un error. | Define el mensaje multilingüe predeterminado para visitantes. Una regla puede sustituirlo. |
El módulo también instala TRACK_OS, TRACK_BROWSER, TRACK_SCREEN y TRACK_USERAGENT con valor 1. El recopilador los lee, pero el formulario actual de Configuración no ofrece controles para ellos. Regulan el almacenamiento de sistema operativo, navegador/versión, pantalla y user-agent sin procesar. No suprimen la recopilación de IP, país o tipo de dispositivo.
Comprobar la información del cliente
El panel del cliente muestra los últimos datos recopilados: IP, país, sistema operativo, navegador/versión, dimensiones de pantalla, tipo de dispositivo y fecha de recopilación, además del historial de IP registrado. Cuando "Show Info on Orders" está activado, el panel de pedido usa el registro del cliente del pedido.
El recopilador del navegador se carga mediante displayHeader y solicita el controlador collect del módulo unos 1,5 segundos después de que la página esté lista. Envía las dimensiones de window.screen, no las del área visible. Con sessionStorage operativo, registra una solicitud enviada por sesión de pestaña del navegador. Si el almacenamiento no está disponible, puede reintentarlo en páginas posteriores.
La recopilación del servidor también se ejecuta después de un inicio de sesión correcto y de crear una cuenta. Evita una fila nueva para la misma IP y cliente o invitado durante una hora. Una solicitud posterior de pantalla puede completar dimensiones ausentes en una fila reciente existente. Estas fechas no son un historial continuo de presencia en directo.
La detección de país prueba la cabecera de país de Cloudflare, después la compatibilidad GeoIP disponible de PrestaShop y luego la cookie de país. Puede no devolver ningún país. Las reglas por país dependen de esos valores.
Añadir entradas a la lista blanca
Abre Lista blanca de IP y añade tu dirección o red de confianza:
| Campo | Valor de entrada nueva | Qué hacer |
|---|---|---|
| Dirección IP | Vacío | Introduce una IP exacta, un patrón comodín o un rango IPv4 compatible. |
| Rango CIDR | Vacío | Introduce una subred IPv4 como 203.0.113.0/24. |
| Etiqueta | Vacío | Añade una nota interna como IP de oficina o VPN del desarrollador. |
Ejemplos: dirección exacta 203.0.113.10, comodín 203.0.113.* y CIDR 203.0.113.0/24. La lista blanca usa el mismo comparador de IP que los bloqueos. Se comprueba antes de los bloqueos y también prevalece sobre las reglas de país y user-agent.
Los registros guardan el contexto de tienda. En multitienda, las comprobaciones de lista blanca incluyen la tienda actual y entradas con ID de tienda 0. Las reglas de bloqueo con ID de tienda positivo solo se aplican a esa tienda; 0 significa todas las tiendas.
Añadir una regla de bloqueo
Abre IP bloqueadas, añade una regla y rellena un solo criterio de coincidencia para la primera prueba.
| Campo | Valor de entrada nueva | Qué hacer |
|---|---|---|
| Dirección IP | Vacío | Introduce una dirección exacta, un comodín como 192.0.2.* o un rango IPv4 como 198.51.100.10-198.51.100.200. |
| Rango CIDR | Vacío | Introduce una subred IPv4 como 192.0.2.0/24. |
| País | Vacío | Selecciona un código de país de dos letras para compararlo con el país detectado. |
| Patrón de User Agent | Vacío | Usa texto sin distinguir mayúsculas y minúsculas, como BadBot, o una regex delimitada por barras, como /BadBot|Scraper/. |
| Tipo de bloqueo | Bloqueo completo - Tienda completa (full) |
Elige Solo proceso de compra (checkout) o Solo inicio de sesión/autenticación (auth) para limitar la aplicación. |
| Motivo | Vacío | Añade una nota interna. No es el mensaje del visitante. |
| Mensaje de prohibición personalizado | Vacío | Sustituye "Default Ban Message" para esta regla. |
| Activo | Sí | Desactívalo para conservar la regla sin aplicarla. |
| Fecha de caducidad | Vacío | Define una fecha/hora futura para un bloqueo temporal o deja vacío para que no caduque. |
Los valores guardados son full, checkout y auth. Varios criterios en una regla actúan como coincidencias alternativas. No significan que el visitante deba coincidir con todos los campos.
Los bloqueos completos se aplican en todo el front office. El ámbito de compra coincide con los controladores order, orderopc, cart, supercheckout, onepagecheckout y checkout. El ámbito de cuenta coincide con authentication, my-account, identity, registration y password. El ámbito sigue el controlador de la página solicitada; las rutas personalizadas de compra o cuenta deben usar los nombres de controlador correspondientes.
Una regla coincidente devuelve HTTP 403 Forbidden con la página Acceso restringido. No hay redirección. Los bloqueos activos caducados se desactivan durante una comprobación posterior, sin necesitar una tarea cron.
Verificar y gestionar reglas
Prueba desde una dirección que controles manteniendo tu conexión de confianza en la lista blanca. Confirma que un bloqueo completo impide navegar, que un bloqueo de compra afecta a los controladores esperados y que una regla inactiva o caducada ya no bloquea esa solicitud. Confirma que las solicitudes de la lista blanca pasan.
Las listas administrativas permiten filtrar, editar/eliminar y exportar. La lista de bloqueos incluye activación/desactivación masiva. Revisa el acceso del personal a esas pantallas con los perfiles de empleados de PrestaShop.
Para una prueba temporal de compra, usa un rango IPv4, Tipo de bloqueo checkout, Activo Sí y una caducidad futura. Las fechas anteriores al momento de la prueba desactivan la regla.
Resolver problemas y personalizar
- Si no se aplica un bloqueo, comprueba primero "Enable IP Banning", Activo, caducidad, ámbito, tienda y coincidencias de lista blanca.
- Comprueba la IP y el país que detecta la tienda, especialmente detrás de un proxy. La ubicación del navegador o la IP pública esperada pueden diferir de los datos de solicitud usados por el módulo.
- Los rangos IPv4 y CIDR usan
ip2long. Usa coincidencia exacta para IPv6; el módulo no implementa coincidencia de subredes IPv6. - La comparación regex solo se ejecuta si el primer y último carácter son
/. Un patrón con indicadores después de la barra final se trata como texto sin formato según esta regla de detección. - Si falta la información de pantalla del cliente, inspecciona la solicitud collect retardada y los errores JavaScript. Una solicitud bloqueada o un indicador sessionStorage ya definido pueden impedir una nueva solicitud.
- Si falta el panel de pedido, comprueba "Show Info on Orders" y la compatibilidad de hooks de tu página administrativa. El historial empieza al activar la recopilación; no hay importación de dispositivos históricos.
El módulo usa displayHeader, actionFrontControllerInitBefore, displayAdminCustomers, displayAdminOrder, displayBackOfficeHeader, actionAuthentication y actionCustomerAccountAdd. Los ajustes de las hojas de estilos del tema o administración pueden dirigirse a .mprceiipban-panel, su .panel-heading, .badge y las celdas de tabla.
Desactivar o desinstalar
Desactiva por separado "Enable Data Collection" y "Enable IP Banning" para suspender esas acciones. Desinstalar desde "Module Manager" elimina la configuración, entradas administrativas y esquema del módulo, incluidos datos recopilados, bloqueos y registros de lista blanca. Haz antes una copia si los necesitas más adelante.
Preguntas
Aún no hay preguntas sobre este módulo
Pregunta lo que quieras sobre instalación, compatibilidad o configuración. Las respuestas aparecen aquí.
Problemas conocidos
11
Las direcciones IPv6 no coinciden con las reglas de baneo por rangos de IP
Las reglas de baneo que usan notación CIDR (p. ej., 2001:db8::/32) se ignoran porque la función de comparación solo maneja rangos IPv4.
Nota de resolución
Se añadió coincidencia CIDR de IPv6 usando inet_pton() de PHP para comparaciones de direcciones tanto IPv4 como IPv6.
Reglas de bloqueo de una sola IP no guardables
Guardar y permanecer omitía la validación o salía de la página
Las etiquetas de administración seguían en inglés
El módulo no cargaba en PHP 7.1
Refuerzo de la seguridad
Las clases del módulo no se cargaban
Traducciones del módulo dañadas
Migración incorrecta de los ajustes existentes del módulo
Fallo de administración con componentes compartidos
Filtros de listas de administración poco fiables
Solicitudes de funcionalidades
4
Implementado
Bloqueo de subredes IPv4 con notación CIDR
Administración multilingüe
Actualizaciones con un clic
Coordinación de módulos de protección
Registro de cambios
v2.0.62026-07-15
- Addedcomplete FR/DE/ES/IT/PL translations
- FixedMigrate module state to MPR config
Versiones anteriores
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
Prueba el módulo completo antes de comprar
Compra la licencia más tarde y conserva tus ajustes.
- Tu demo de 30 días Pruébalo en tu propia tienda durante 30 días desde la primera instalación.
- Tienda demo lista Explora una tienda demo lista en tu navegador.
- Sin registro Sin cuenta, correo ni dominio de tienda.
Al descargar, aceptas las condiciones de la demo y la política de privacidad.
Al abrir esta demo, acepta los términos de la demo y la política de privacidad.