Journaux d’audit

Consultez un historique des actions modifiant l’état de votre organisation, où seuls les ajouts sont autorisés et toute altération est détectable — qui a fait quoi, quand et depuis où.

Les journaux d’audit présentent une chronologie des actions administratives prises en charge dans votre organisation, avec recherche et filtres : attribution de rôles, modification de moteurs et création de clés API. Consultez les limites de couverture. Ils sont disponibles avec le forfait Enterprise, tout comme les Rôles et permissions.

Au niveau de la base de données, le journal n’autorise que les ajouts : la connexion de l’application ne peut ni modifier ni supprimer les lignes d’audit, ni vider la table. Ce qui est écrit reste écrit.

Ce qui est enregistré #

Chaque événement enregistre l’auteur, l’action, la cible et le contexte HTTP dans lequel la requête a été reçue.

ChampRemarques
AuteurL’utilisateur ou la clé API à l’origine de l’action
ActionUne valeur typée, comme engine.created ou member.role_changed
CibleL’entité concernée (par exemple, un moteur, un rôle ou une entrée de glossaire)
MétadonnéesIdentifiants des entités associées — jamais de noms, d’adresses e-mail ni d’extraits de contenu
Contexte de la requêterequest_id, adresse IP, agent utilisateur — enregistrés à la réception d’un appel HTTP
HorodatageUTC, avec un numéro de séquence monotone pour détecter les interruptions dans la séquence

Des identifiants uniquement : un choix de conception

La colonne des métadonnées stocke des identifiants, pas des valeurs directement lisibles. L’interface les associe aux noms actuels au moment de la lecture : renommer un moteur ou un utilisateur ne réécrit donc pas l’historique. Ce choix évite aussi tout conflit entre les lignes d’audit et le droit à l’effacement prévu par le RGPD — aucun contenu n’est à supprimer.

Actions couvertes #

Les événements sont regroupés en catégories correspondant à celles du filtre du tableau de bord.

CatégorieActions actuellement enregistrées
Organisationorg.created, org.settings_updated, org.deleted
Membresmember.invited, member.removed, member.role_changed
Rôlesrole.created, role.updated, role.deleted
Moteursengine.created, engine.updated, engine.deleted
Clés APIapi_key.created, api_key.revoked
Contenuglossary_item.*, instruction.*, brand_voice.* (opérations unitaires uniquement)

Accéder au journal #

L’entrée Journal d’audit apparaît toujours dans Paramètres, sous Administration. Si votre forfait ne donne pas accès à cette fonctionnalité, la page affiche « Le journal d’audit n’est pas disponible avec votre forfait » à la place de la chronologie. Dans le journal, vous trouverez :

  • Liste filtrable — filtrez par Action, Auteur et Période (une période prédéfinie comme 7 derniers jours, ou une plage de dates Du / Au). Les dates futures ne peuvent pas être sélectionnées.
  • Charger les événements plus anciens — les événements les plus récents apparaissent en premier ; cliquez sur Charger les événements plus anciens en bas de la liste pour charger la page suivante.
  • Détails de l’événement — cliquez sur une ligne pour la développer directement dans la liste et consulter l’ensemble des métadonnées, l’identifiant de la requête, l’adresse IP et l’agent utilisateur.
  • Vues partageables — les filtres et l’événement ouvert sont repris dans l’URL : vous pouvez ainsi partager n’importe quelle vue.

Qui peut consulter le journal #

L’accès à la page dépend de deux conditions :

  1. Droit d’accès — la fonctionnalité de journaux d’audit doit être activée pour l’organisation (forfait Enterprise).
  2. Permission — le rôle de la personne qui consulte le journal doit inclure org:view_audit_logs. Le rôle prédéfini Accès complet l’inclut par défaut ; les Propriétaires disposent toujours de cette permission.

Les membres qui n’ont pas cette permission voient une page « Aucun accès » à la place de la chronologie. Si leur organisation ne dispose pas du droit d’accès requis, une page les invite à souscrire un forfait.

Si votre forfait Enterprise expire

L’accès aux journaux d’audit dépend du même niveau de forfait que le RBAC. Les événements passés restent dans la base de données, mais la page affiche « Le journal d’audit n’est pas disponible avec votre forfait » et les points de terminaison de lecture renvoient une erreur 403 jusqu’au rétablissement du forfait.

Détection des altérations #

Les journaux d’audit ne se contentent pas de garder une trace : ils sont réellement difficiles à modifier après coup.

  • Ajouts uniquement au niveau de la base de données. La migration qui crée la table exécute REVOKE UPDATE, DELETE, TRUNCATE sur le rôle API. Toute tentative de modification via un futur chemin d’exécution — bug, nouveau point de terminaison, voire injection SQL — est rejetée par Postgres avant de pouvoir modifier une ligne.
  • Séquence monotone. Chaque ligne contient une colonne seq dont la valeur est strictement croissante. En parcourant la séquence, un auditeur peut repérer les suppressions grâce aux numéros manquants.

Ces mesures suffisent pour des contrôles de type SOC 2. Elles ne protègent pas contre un attaquant disposant d’identifiants d’accès directs à la base de données de production — des protections renforcées (rôle propriétaire distinct, miroir WORM) sont disponibles sur demande.

Conservation #

Par défaut, les événements d’audit sont conservés indéfiniment. Des durées de conservation personnalisées — généralement 1, 3 ou 7 ans — sont disponibles avec Enterprise. Contactez-nous si vous avez besoin d’une politique de conservation spécifique pour répondre à des exigences de conformité ou à des questionnaires de sécurité.

Ce qui n’est pas couvert #

Voici quelques limites volontairement fixées pour la v1 :

  • Émission sans garantie, non transactionnelle. L’émission transactionnelle est prévue à court terme. L’événement d’audit est écrit après l’action qu’il décrit — et non dans la même transaction de base de données. Dans de rares cas de défaillance (l’action réussit, puis l’insertion de l’événement d’audit échoue), l’action peut avoir lieu sans événement correspondant.
  • Certains types d’actions ne sont pas encore enregistrés. Les changements d’appartenance à un moteur, la connexion / mise à jour / déconnexion d’intégrations, les modifications de configuration des modèles, les changements d’abonnement de facturation et les opérations de contenu en masse (import CSV, createMany / updateMany / deleteMany) ne produisent pas encore d’événements. Les noms de ces actions sont réservés pour qu’elles apparaissent dans les catégories de filtres existantes une fois leur enregistrement activé.
  • Les lectures ne sont pas auditées. Consulter le journal d’audit lui-même, parcourir les journaux de requêtes d’un moteur ou télécharger un glossaire ne produit pas d’événement. Seules les actions modifiant l’état en produisent.
  • Pas encore d’export. Les données d’audit sont accessibles dans le tableau de bord. L’export CSV, un webhook SIEM et un miroir S3 sont prévus — dites-nous si vous en avez besoin.
  • Pas de vue limitée à un moteur. Tous les événements d’audit de l’organisation figurent dans une seule chronologie. Filtrez par action ou par auteur pour affiner la vue.
  • Pas de suivi en direct. Il n’y a ni bouton Actualiser ni flux WebSocket — rechargez la page pour afficher les événements plus récents.

Prochaines étapes #