Información adicional del cliente (bloqueo IP): configuración y ayuda

Inicio rápido

  1. Sube el ZIP del módulo en "Modules > Module Manager" y abre "Configure".
  2. Activa "Enable Data Collection" y elige "Track Guest Visitors".
  3. Elige "Show Info on Orders", configura "Default Ban Message" y guarda.
  4. Inicia sesión como cliente de prueba y verifica la información recopilada en el back office.
  5. Añade tu IP de confianza en Lista blanca de IP.
  6. Añade una regla de prueba controlada en IP bloqueadas con Tipo de bloqueo, Activo y una Fecha de caducidad futura opcional.
  7. 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

  1. Sube Customer Extra Info (IP Ban) en "Modules > Module Manager".
  2. Abre "Configure" para acceder a Configuración.
  3. Revisa los interruptores de recopilación y del panel de pedidos, y guarda.
  4. 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.
  5. 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

Abierto

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

ResueltoActualizado:
Corregido en: 2.0.16
Guardar un bloqueo para una sola dirección IP podía fallar si no se introducía un rango de red.

Guardar y permanecer omitía la validación o salía de la página

ResueltoActualizado:
Corregido en: 2.0.16
Guardar y permanecer no siempre validaba los ajustes enviados o mantenía al comerciante en la página actual.

Las etiquetas de administración seguían en inglés

ResueltoActualizado:
Corregido en: 2.0.16
Las etiquetas traducidas de la administración del módulo podían seguir apareciendo en inglés.

El módulo no cargaba en PHP 7.1

ResueltoActualizado:
Corregido en: 2.0.12
El módulo podía rechazarse en PHP 7.1 por requisitos incorrectos en su paquete.

Refuerzo de la seguridad

ResueltoActualizado:
Corregido en: 2.0.11
Refuerzo de la seguridad.

Las clases del módulo no se cargaban

ResueltoActualizado:
Corregido en: 2.0.11
El módulo podía no cargar los componentes necesarios tras una actualización.

Traducciones del módulo dañadas

ResueltoActualizado:
Corregido en: 2.0.11
Algunos textos de administración mostraban traducciones dañadas.

Migración incorrecta de los ajustes existentes del módulo

ResueltoActualizado:
Corregido en: 2.0.7
La migración de los ajustes del módulo podía no conservar la configuración guardada.

Fallo de administración con componentes compartidos

ResueltoActualizado:
Corregido en: 2.0.7
La administración del módulo podía fallar si faltaba el soporte de compatibilidad necesario u otro módulo ya había cargado un componente compartido.

Filtros de listas de administración poco fiables

ResueltoActualizado:
Corregido en: 2.0.6
Los filtros de listas de administración podían ignorar los valores seleccionados o devolver resultados incorrectos.

Solicitudes de funcionalidades

4

Implementado

Bloqueo de subredes IPv4 con notación CIDR

Implementado
Puedes bloquear una subred IPv4 completa mediante notación CIDR, por ejemplo /24. Los rangos IPv6 no son compatibles.

Administración multilingüe

Implementado
Usa los textos de administración del módulo en francés, alemán, español, italiano y polaco.

Actualizaciones con un clic

Implementado
Actualiza el módulo desde su página de administración.

Coordinación de módulos de protección

Implementado
Coordina el bloqueo de IP con otros módulos instalados que ofrecen protección de cortafuegos.

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.
Iniciar tienda demo

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.

Cargando...
Volver arriba