PS PrestaShop Intermedio

Registro de auditoría del back-office — Guía completa

Instalación, configuración y uso del registro de auditoría del back office: cronología, comparación antes/después, comprobación de integridad, configuración, alertas por correo y exportaciones.

Actualizado Versión del módulo 2.0.0

Presentación

El módulo Registro de auditoría para el back office registra quién cambió qué, y cuándo: creaciones, modificaciones y eliminaciones de objetos con la comparación antes/después, configuración de la tienda y de los módulos, módulos instalados o desactivados, permisos, inicios de sesión correctos y fallidos. Los secretos nunca se almacenan, los datos personales de los clientes se minimizan y una cadena de hashes permite comprobar que el registro no se ha reescrito.

Versión 2.0.0, compatible con PrestaShop 1.7.8, 8 y 9 (PHP 7.1 a 8.5), una tienda o multitienda, interfaz en 8 idiomas. Sin override del núcleo.

El módulo ayuda a la trazabilidad. Por sí solo no hace que una tienda cumpla una normativa (RGPD, NIS2, PCI DSS…).

Instalación

  1. Abra Módulos > Gestor de módulos, haga clic en Subir un módulo y suelte el archivo ZIP.
  2. Aparece el menú Parámetros Avanzados > Registro de auditoría, con cuatro pestañas: Registro, Panel de control, Integridad, Configuración.
  3. El preajuste Recomendado está activo: no hace falta nada más para empezar.

Al instalarse, el módulo se activa en todas las tiendas y concede a todos los perfiles el permiso «ver» sobre el propio módulo. En PrestaShop 1.7.8, sin este permiso, PrestaShop no ejecuta los hooks del módulo para los empleados del perfil y sus acciones no se registrarían. Este permiso no da acceso al registro, que tiene su propio permiso.

Actualización desde la versión 1.0.0

Suba el nuevo ZIP como para una instalación y, a continuación, ejecute la actualización. Las entradas y la configuración se conservan. Los secretos que la 1.0.0 pudo almacenar (claves de webservice, tokens en las URL, valores de parámetros secretos) se enmascaran durante la actualización. Las entradas de la 1.0.0 se marcan como «sin sellar»: no forman parte de la cadena de hashes. Un módulo desactivado sigue desactivado.

El registro

La pestaña Registro presenta una cronología por día. Cada entrada se lee como una frase («Thomas Petit modificó: producto “Camiseta colibrí”»), con la hora, la dirección IP, la tienda, el origen (back office, webservice, línea de comandos…) y los campos modificados. Una barra naranja señala las acciones sensibles.

Cronología del registro de auditoría: quién cambió qué y cuándo en el back office de PrestaShop
Cronología del registro de auditoría

Los accesos directos de la parte superior filtran con un clic: todos los cambios, inicios de sesión y sesiones, configuración, módulos, permisos, eventos del registro, acciones sensibles. Más filtros despliega empleado, tipo de objeto, acción, período, dirección IP, origen, importancia y tienda. La búsqueda abarca nombres, referencias, correos electrónicos, campos y valores (salvo los valores enmascarados).

Filtros de inicios de sesión: intentos fallidos repetidos desde la misma dirección IP
Filtros de inicios de sesión fallidos

Vista detallada

Detalles abre la entrada: quién (autor, correo electrónico, perfil, origen), dónde y cómo (objeto, tienda, IP, página, navegador) y, después, la comparación campo por campo. Cada idioma y cada tienda tiene su propia línea; en los textos largos, las palabras eliminadas aparecen tachadas en rojo y las añadidas resaltadas en verde. Un valor secreto o personal enmascarado se indica con un candado. Los botones abren el objeto y su historial completo; la sección «Misma petición» enumera las demás entradas de la misma acción.

Detalle de una entrada con la comparación antes/después de un producto, palabra por palabra
Comparación antes/después

Historial en las fichas

Las fichas de producto (pestaña Módulos), pedido y cliente muestran las últimas entradas del objeto, con un enlace al historial completo. El bloque solo aparece para los empleados que tienen acceso al registro.

Historial de cambios mostrado en la ficha del producto
Historial de cambios en la ficha de producto

Qué se registra

  • Objetos: más de 45 tipos (productos, combinaciones, precios específicos, stock, categorías, pedidos y cambios de estado, pagos, facturas por abono, clientes, direcciones, reglas del carrito, transportistas, impuestos, países, idiomas, páginas, empleados, perfiles, claves de webservice, consultas SQL, tiendas…). Puede añadir clases de otros módulos.
  • Configuración: en cada formulario del back office que modifica algo, se compara la configuración antes y después, incluidas las páginas de configuración de los módulos.
  • Módulos: instalación, desinstalación, activación, desactivación, actualización.
  • Permisos: Equipo > Permisos, permisos de las claves de webservice, cambio de perfil de un empleado.
  • Inicios de sesión: correctos, fallidos (el identificador solo se conserva si tiene forma de correo electrónico), cierres de sesión (1.7.8 y 8) y sesiones finalizadas (9); «iniciar sesión como cliente» con el módulo dfconnectas.
  • Operaciones masivas: por encima del umbral de agrupación (25 por defecto), una misma acción sobre muchos objetos se convierte en una sola entrada con el número, los identificadores y los campos modificados. También se registran las operaciones de los módulos dfbulkfeature y dfspecificpricecleaner.

Qué no se registra

  • las escrituras SQL directas realizadas por otros módulos (salvo los dos módulos citados);
  • los parámetros modificados desde la línea de comandos, por una tarea cron o mediante el webservice;
  • los clientes de la API de administración de PrestaShop 9.

Panel de control

Acciones de los últimos 7 días, modificaciones y eliminaciones, inicios de sesión fallidos (24 h y 7 días), acciones sensibles, gráfico de actividad de 30 días (un clic en una columna abre ese día), empleados más activos, objetos más modificados, estado de la protección (última comprobación, alertas, tamaño del registro) y últimas acciones sensibles. Unos avisos señalan cualquier perfil o tienda que escaparía al registro.

Panel: actividad de 30 días, inicios de sesión fallidos y acciones sensibles
Panel del registro de auditoría

Integridad

Cada entrada contiene la huella SHA-256 de la anterior. Comprobar ahora recalcula toda la cadena por lotes y señala cualquier entrada modificada, eliminada o insertada, con un enlace a cada entrada afectada. La comprobación también queda registrada.

Verificación de integridad de la cadena de hash y huella para guardar fuera de la tienda
Verificación de integridad del registro
  • Ninguna entrada puede modificarse ni eliminarse individualmente desde el back office.
  • La única eliminación es la purga de retención, que también queda registrada; la cadena sigue siendo verificable.
  • El borrado de los datos de un cliente elimina valores pero mantiene la cadena verificable; se señala como tal.

Límite: una persona con acceso directo a la base de datos puede reescribir todo el registro y recalcular la cadena. Copie la huella mostrada (número y huella de la última entrada) en un lugar aparte y compárela más adelante, exporte con regularidad o active la copia a syslog si los registros de su servidor se recopilan en otro lugar.

Los módulos de copia de seguridad, de preproducción y de migración copian las tablas del registro como las demás: restaurar una copia de seguridad antigua también restaura el registro antiguo.

Configuración

La pestaña Configuración empieza con tres preajustes: Ligero (objetos esenciales, datos personales no registrados, IP truncada, 90 días), Recomendado (365 días, datos personales parcialmente enmascarados) y Completo (todos los objetos, 730 días). La aplicación de un preajuste queda anotada en el registro.

Ajustes con preajustes y objetos a registrar
Ajustes y preajustes del registro

Qué se registra

Marque los tipos de objetos y active los eventos: inicios de sesión, configuración, módulos, permisos, valores de los objetos creados y eliminados. Las acciones del back office siempre se registran; el webservice y la API de administración, la línea de comandos, el front office y las tareas cron son opcionales (front office desactivado por defecto). Los carritos, visitas y estadísticas nunca se registran.

Datos personales y secretos

  • Datos de los clientes: parcialmente enmascarados (j•••@e•••.com, •• •• •• 42), no registrados o completos si tiene una necesidad documentada.
  • Borrado: cuando se elimina un cliente, o a petición con el módulo psgdpr, sus datos personales se retiran del registro.
  • Dirección IP del empleado: completa, truncada (203.0.113.0) o no registrada; navegador opcional.
  • Secretos: nunca se registran (contraseñas y hashes, claves, tokens, claves de webservice, secretos de pago y OAuth, credenciales FTP). Puede añadir campos y parámetros que enmascarar, y parámetros que ignorar.

Retención y volumen

Período de retención en días (mínimo 30, o 0 para ilimitado), purga automática una vez al día. El umbral de agrupación, el número de campos por entrada y la longitud de los valores protegen la base de datos durante las importaciones.

Acceso y exclusiones

El registro solo es visible para los perfiles que tienen el permiso sobre el menú Registro de auditoría (Equipo > Permisos): Ver para leer y exportar, Modificar para la configuración, Eliminar para aplicar la retención. El botón Crear un perfil «Auditor (solo lectura)» prepara un perfil dedicado. En multitienda, un empleado solo ve las entradas de sus tiendas. Los empleados excluidos no se registran: esta elección también queda registrada y no puede excluirse a sí mismo.

Alertas por correo electrónico

Active las alertas e introduzca hasta 10 destinatarios. Se envían en caso de inicios de sesión fallidos repetidos (5 en 15 minutos por defecto, mismo correo electrónico o misma IP), una eliminación masiva (20 objetos en 10 minutos por defecto), cambios de empleados, perfiles, permisos y claves de webservice, módulos instalados, activados o desactivados, un parámetro secreto modificado, y siempre ante un cambio del propio registro. Cada alerta se envía en el idioma del destinatario, como máximo una vez cada 15 minutos para un mismo evento, y nunca contiene ningún valor. El botón Enviar una alerta de prueba comprueba la configuración de correo electrónico de la tienda.

Alerta por correo electrónico tras inicios de sesión fallidos repetidos en el back office
Alerta por correo de inicios de sesión fallidos

Exportaciones

Los botones CSV y JSON del registro exportan las entradas que muestran los filtros actuales (100 000 como máximo), con los campos modificados y las huellas. Los valores enmascarados siguen enmascarados, y las celdas CSV que una hoja de cálculo podría interpretar como fórmulas se neutralizan. Cada exportación queda registrada.

Desinstalación

La desinstalación siempre se registra. El parámetro Al desinstalar decide qué ocurre con el registro: Conservar el registro (recomendado: las tablas se mantienen y una reinstalación continúa la misma cadena) o Eliminar el registro (expórtelo antes si puede necesitarlo).

Solución de problemas

Las acciones de un empleado no aparecen

Consulte los avisos del panel de control: empleado excluido, perfil sin el permiso «ver» sobre el módulo (PrestaShop 1.7.8) o tienda en la que el módulo está desactivado.

Un cambio de configuración no aparece

Solo se comparan los parámetros modificados desde un formulario del back office. Compruebe también que el parámetro no figure en la lista de parámetros que ignorar.

La integridad señala un problema

Abra la entrada indicada. Una eliminación o una modificación hecha directamente en la base de datos, o la restauración de una copia de seguridad antigua, rompe la cadena en ese punto. Los valores borrados a petición de un cliente no se cuentan como alteraciones.

¿Te ha resultado útil esta página?

¿Sigues atascado? Contacta con soporte