PS PrestaShop Intermédiaire

Journal d’audit BO — Guide complet

Installer, configurer et utiliser le journal d'audit du back-office 2.0.0 : chronologie, comparaison avant/après, réglages, modules, permissions et connexions, secrets jamais stockés, données personnelles minimisées, intégrité, alertes et exports, pour PrestaShop 1.7.8 à 9.

Mis à jour Version du module 2.0.0

Présentation

Le module Journal d’audit du back-office enregistre qui a modifié quoi, et quand : créations, modifications et suppressions d’objets avec la comparaison avant/après, réglages de la boutique et des modules, modules installés ou désactivés, permissions, connexions réussies et échouées. Les secrets ne sont jamais stockés, les données personnelles des clients sont minimisées et une chaîne de hachage permet de vérifier que le journal n’a pas été réécrit.

Version 2.0.0, compatible PrestaShop 1.7.8, 8 et 9 (PHP 7.1 à 8.5), mono ou multi-boutique, interface en 8 langues. Aucun override du cœur.

Le module aide à la traçabilité. Il ne rend pas à lui seul une boutique conforme à une réglementation (RGPD, NIS2, PCI DSS…).

Installation

  1. Ouvrez Modules > Gestionnaire de modules, cliquez sur Installer un module et déposez l’archive ZIP.
  2. Le menu Paramètres avancés > Journal d’audit apparaît, avec quatre onglets : Journal, Tableau de bord, Intégrité, Réglages.
  3. Le préréglage Recommandé est actif : rien d’autre n’est obligatoire pour commencer.

À l’installation, le module est activé dans toutes les boutiques et donne à tous les profils le droit « voir » sur le module lui-même. Sur PrestaShop 1.7.8, sans ce droit, PrestaShop n’exécute pas les hooks du module pour les employés du profil et leurs actions ne seraient pas enregistrées. Ce droit ne donne pas accès au journal, qui a sa propre permission.

Mise à jour depuis la version 1.0.0

Déposez le nouveau ZIP comme pour une installation, puis lancez la mise à jour. Les entrées et les réglages sont conservés. Les secrets que la 1.0.0 avait pu stocker (clés webservice, jetons dans les URL, valeurs de réglages secrets) sont masqués pendant la mise à jour. Les entrées de la 1.0.0 sont signalées « non scellées » : elles ne font pas partie de la chaîne de hachage. Un module désactivé reste désactivé.

Le journal

L’onglet Journal présente une chronologie par jour. Chaque entrée se lit comme une phrase (« Thomas Petit a modifié « T-shirt colibri » (produit) »), avec l’heure, l’adresse IP, la boutique, l’origine (back-office, webservice, ligne de commande…) et les champs modifiés. Une barre orange signale les actions sensibles.

Chronologie du journal d'audit : qui a modifié quoi et quand dans le back-office PrestaShop
Chronologie du journal d’audit

Les raccourcis en haut filtrent d’un clic : toutes les modifications, connexions et sessions, réglages, modules, permissions, événements du journal, actions sensibles. Plus de filtres ouvre l’employé, le type d’objet, l’action, la période, l’adresse IP, l’origine, l’importance et la boutique. La recherche porte sur les noms, références, e-mails, champs et valeurs (sauf les valeurs masquées).

Filtres sur les connexions : tentatives échouées répétées depuis la même adresse IP
Filtres sur les connexions échouées

Vue détaillée

Détails ouvre l’entrée : qui (auteur, e-mail, profil, origine), où et comment (objet, boutique, IP, page, navigateur), puis la comparaison champ par champ. Chaque langue et chaque boutique a sa ligne ; dans les textes longs, les mots retirés sont barrés en rouge et les mots ajoutés surlignés en vert. Une valeur secrète ou personnelle masquée est signalée par un cadenas. Les boutons ouvrent l’objet et son historique complet ; la section « Même requête » liste les autres entrées de la même action.

Détail d'une entrée avec la comparaison avant/après d'un produit, mot à mot
Comparaison avant/après

Historique sur les fiches

Les fiches produit (onglet Modules), commande et client affichent les dernières entrées de l’objet, avec un lien vers l’historique complet. Le bloc n’apparaît que pour les employés qui ont accès au journal.

Historique des modifications affiché sur la fiche produit
Historique des modifications sur la fiche produit

Ce qui est enregistré

  • Objets : plus de 45 types (produits, déclinaisons, prix spécifiques, stocks, catégories, commandes et changements d’état, paiements, avoirs, clients, adresses, règles panier, transporteurs, taxes, pays, langues, pages, employés, profils, clés webservice, requêtes SQL, boutiques…). Vous pouvez ajouter des classes d’autres modules.
  • Réglages : à chaque formulaire du back-office qui modifie quelque chose, la configuration est comparée avant et après, pages de configuration des modules comprises.
  • Modules : installation, désinstallation, activation, désactivation, mise à jour.
  • Permissions : Équipe > Permissions, permissions des clés webservice, changement de profil d’un employé.
  • Connexions : réussies, échouées (l’identifiant n’est gardé que s’il a la forme d’un e-mail), déconnexions (1.7.8 et 8) et fins de session (9) ; « connexion en tant que client » avec le module dfconnectas.
  • Opérations de masse : au-delà du seuil de regroupement (25 par défaut), une même action sur de nombreux objets devient une seule entrée avec le nombre, les identifiants et les champs changés. Les opérations des modules dfbulkfeature et dfspecificpricecleaner sont aussi enregistrées.

Ce qui n’est pas capté

  • les écritures SQL directes faites par d’autres modules (sauf les deux modules cités) ;
  • les réglages modifiés en ligne de commande, par une tâche cron ou par webservice ;
  • les clients de l’API d’administration de PrestaShop 9.

Tableau de bord

Actions des 7 derniers jours, modifications et suppressions, connexions échouées (24 h et 7 jours), actions sensibles, graphique d’activité sur 30 jours (un clic sur une colonne ouvre la journée), employés les plus actifs, objets les plus modifiés, état de la protection (dernière vérification, alertes, taille du journal) et dernières actions sensibles. Des avertissements signalent un profil ou une boutique qui échapperait au journal.

Tableau de bord : activité sur 30 jours, connexions échouées et actions sensibles
Tableau de bord du journal d’audit

Intégrité

Chaque entrée contient l’empreinte SHA-256 de la précédente. Vérifier maintenant recalcule toute la chaîne par lots et signale une entrée modifiée, supprimée ou insérée, avec un lien vers chaque entrée concernée. La vérification est elle-même enregistrée.

Vérification d'intégrité de la chaîne de hachage et empreinte à garder hors de la boutique
Vérification d’intégrité du journal
  • Aucune entrée ne peut être modifiée ni supprimée une à une depuis le back-office.
  • La seule suppression est la purge de conservation, elle-même enregistrée ; la chaîne reste vérifiable.
  • L’effacement des données d’un client retire des valeurs mais laisse la chaîne vérifiable ; il est signalé comme tel.

Limite : une personne ayant un accès direct à la base de données peut réécrire tout le journal et recalculer la chaîne. Copiez l’empreinte affichée (numéro et empreinte de la dernière entrée) dans un endroit séparé et comparez-la plus tard, exportez régulièrement, ou activez la copie vers syslog si les journaux de votre serveur sont collectés ailleurs.

Les modules de sauvegarde, de préproduction et de migration copient les tables du journal comme les autres : restaurer une ancienne sauvegarde restaure aussi l’ancien journal.

Réglages

L’onglet Réglages commence par trois préréglages : Léger (objets essentiels, données personnelles non enregistrées, IP tronquée, 90 jours), Recommandé (365 jours, données personnelles partiellement masquées) et Complet (tous les objets, 730 jours). Appliquer un préréglage est enregistré dans le journal.

Réglages avec préréglages Léger, Recommandé et Complet et objets à enregistrer
Réglages et préréglages du journal d’audit

Ce qui est enregistré

Cochez les types d’objets et activez les événements : connexions, réglages, modules, permissions, valeurs des objets créés et supprimés. Les actions du back-office sont toujours enregistrées ; le webservice et l’API d’administration, la ligne de commande, le front-office et les tâches cron sont des options (front-office désactivé par défaut). Les paniers, visites et statistiques ne sont jamais enregistrés.

Données personnelles et secrets

  • Données des clients : partiellement masquées (j•••@e•••.com, •• •• •• 42), non enregistrées, ou complètes si vous avez un besoin documenté.
  • Effacement : quand un client est supprimé, ou sur demande avec le module psgdpr, ses données personnelles sont retirées du journal.
  • Adresse IP de l’employé : complète, tronquée (203.0.113.0) ou non enregistrée ; navigateur en option.
  • Secrets : jamais enregistrés (mots de passe et hachages, clés, jetons, clés webservice, secrets de paiement et OAuth, identifiants FTP). Vous pouvez ajouter des champs et des réglages à masquer, et des réglages à ignorer.

Conservation et volume

Durée de conservation en jours (minimum 30, ou 0 pour illimité), purge automatique une fois par jour. Le seuil de regroupement, le nombre de champs par entrée et la longueur des valeurs protègent la base pendant les imports.

Accès et exclusions

Le journal n’est visible que par les profils ayant la permission sur le menu Journal d’audit (Équipe > Permissions) : Voir pour lire et exporter, Modifier pour les réglages, Supprimer pour appliquer la conservation. Le bouton Créer un profil « Auditeur (lecture seule) » prépare un profil dédié. En multi-boutique, un employé ne voit que les entrées de ses boutiques. Les employés exclus ne sont pas enregistrés : ce choix est lui-même enregistré et vous ne pouvez pas vous exclure vous-même.

Alertes e-mail

Activez les alertes et saisissez jusqu’à 10 destinataires. Elles sont envoyées pour les connexions échouées répétées (5 en 15 minutes par défaut, même e-mail ou même IP), une suppression massive (20 objets en 10 minutes par défaut), les changements d’employés, profils, permissions et clés webservice, les modules installés ou basculés, un réglage secret modifié, et toujours pour un changement du journal lui-même. Chaque alerte est envoyée dans la langue du destinataire, au plus une fois toutes les 15 minutes pour un même événement, sans jamais contenir de valeur. Le bouton Envoyer une alerte de test vérifie la configuration e-mail de la boutique.

Alerte par e-mail après des connexions au back-office échouées répétées
Alerte e-mail de connexions échouées

Exports

Les boutons CSV et JSON du journal exportent les entrées affichées par les filtres actuels (100 000 au maximum), avec les champs modifiés et les empreintes. Les valeurs masquées restent masquées, et les cellules CSV qui pourraient être interprétées comme des formules par un tableur sont neutralisées. Chaque export est enregistré.

Désinstallation

La désinstallation est toujours enregistrée. Le réglage À la désinstallation décide du sort du journal : Conserver (recommandé : les tables restent et une réinstallation poursuit la même chaîne) ou Supprimer (exportez avant si vous pouvez en avoir besoin).

Dépannage

Les actions d’un employé n’apparaissent pas

Regardez les avertissements du tableau de bord : employé exclu, profil sans droit « voir » sur le module (PrestaShop 1.7.8) ou boutique où le module est désactivé.

Une modification de réglage n’apparaît pas

Seuls les réglages modifiés depuis un formulaire du back-office sont comparés. Vérifiez aussi que le réglage ne figure pas dans la liste des réglages ignorés.

L’intégrité signale un problème

Ouvrez l’entrée indiquée. Une suppression ou une modification faite directement en base, ou la restauration d’une ancienne sauvegarde, rompt la chaîne à cet endroit. Les valeurs effacées à la demande d’un client ne sont pas comptées comme des altérations.

Cette page vous a-t-elle été utile ?

Toujours bloqué ? Contactez le support