> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Journaux d'audit

> Qui a fait quoi dans un espace de travail : membres, permissions, clés API, intégrations, paramètres et modifications de contenu, avec l'adresse d'origine et le résultat de chaque action. En ajout seul, exportable, avec une durée de conservation que vous choisissez.

## Vue d'ensemble

Le journal d'audit enregistre chaque action du plan de contrôle effectuée sur un déploiement : un membre invité, un jeu de permissions modifié, une clé API créée, une intégration modifiée, un modèle enregistré, une newsletter programmée, un contact supprimé, la licence installée.

Chaque entrée indique l'auteur, l'action, sa cible, l'adresse IP et le user agent d'origine, l'identifiant de la requête, et si l'action a réussi, échoué ou été refusée. Les actions sensibles pour la sécurité portent aussi un avant/après de ce qui a changé, avec chaque secret masqué.

Il n'enregistre jamais le plan de données (upserts de contacts, envois, suivi, événements personnalisés), qui peut atteindre des milliers de requêtes par minute et relève des [Logs](https://www.notifuse.com/fr/docs/features/logs.md).

Les journaux d'audit sont une **fonctionnalité sous licence** (Enterprise) : l'enregistrement n'a lieu que si une clé de licence couvrant `audit_logs` est installée. La consultation, l'export et le réglage de la durée de conservation ne sont jamais bloqués : la page fonctionne quel que soit l'état de la licence, sur ce qui a été enregistré. Voir [Clés de licence](https://www.notifuse.com/fr/docs/self-hosting/licence.md).

Sur Notifuse Cloud, la clé est gérée pour vous, et les journaux d'audit sont enregistrés avec l'offre Business. Voir [Sur Notifuse Cloud](https://www.notifuse.com/fr/docs/self-hosting/licence.md#on-notifuse-cloud).

> [!NOTE]
>
> **Rien n'est refusé, rien n'est caché.** Un déploiement sans licence n'écrit aucune entrée et n'en est pas averti. Un déploiement dont la clé expire arrête l'enregistrement après les 30 jours de grâce et écrit une entrée de repère, `licence.recordingStopped`, pour que l'interruption ne passe pas inaperçue. Réinstaller une clé écrit `licence.recordingResumed`.

## Où le trouver

**Logs → Journal d'audit**, dans un espace de travail, affiche les entrées de cet espace, à côté des logs de messages et de webhooks. Un utilisateur root (un `ROOT_EMAIL`) peut faire passer ce même onglet sur **Tout le déploiement** : tous les espaces de travail, plus les entrées de niveau déploiement qui n'appartiennent à aucun espace (connexions, licence, paramètres système).

Les propriétaires voient toujours l'onglet. Un membre ou une clé API ne le voit que s'il a reçu la permission **Journaux d'audit** en lecture. Cette permission s'accorde explicitement et ne fait jamais partie de l'« accès complet » : un accès complet ne doit pas permettre de lire l'adresse email, l'adresse IP et les actions refusées de chaque collègue. Un membre qui n'a que cette permission voit l'entrée de menu Logs et seulement cet onglet.

Chaque entrée se lit comme une phrase, par exemple « A invité **[ann@example.com](mailto:ann@example.com)** », à côté de l'auteur, de la ressource et, si la requête n'a pas réussi, de son résultat. Cliquer sur une entrée l'ouvre dans un panneau latéral avec l'action, le résultat et le statut HTTP, l'auteur, la cible, l'adresse IP, le user agent, l'identifiant de la requête, l'avant/après de ce qui a changé, les métadonnées et l'entrée brute.

![L'onglet Journal d'audit dans la section Logs](https://www.notifuse.com/docs/assets/screenshots/audit_logs.png)

![Une entrée du journal d'audit ouverte dans son panneau latéral : action, résultat, auteur, cible, adresse IP, user agent, identifiant de requête et métadonnées](https://www.notifuse.com/docs/assets/screenshots/audit_logs_entry.png)

**Paramètres → Journal d'audit** est l'endroit où un propriétaire règle la durée de conservation de l'espace de travail, et où l'avis de licence apparaît quand rien n'est enregistré.

## Contenu d'une entrée

| Champ                                                               | Signification                                                                                                                                                                                                                             |
| ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `occurred_at`                                                       | Moment où l'action s'est terminée, en UTC.                                                                                                                                                                                                |
| `action`                                                            | La route RPC qui l'a effectuée, telle quelle : `workspaces.inviteMember`, `templates.update`, `contacts.delete`.                                                                                                                          |
| `category`                                                          | Un regroupement pour filtrer : `auth`, `licence`, `system`, `workspaces`, `members`, `api_keys`, `integrations`, `webhooks`, `templates`, `broadcasts`, `automations`, `lists`, `segments`, `transactional`, `blog`, `contacts`, `audit`. |
| `outcome`                                                           | `success`, `failure` (la requête a été refusée pour une autre raison, ou une connexion a échoué) ou `denied` (403 ou 402).                                                                                                                |
| `status_code`                                                       | Le statut HTTP renvoyé par la requête.                                                                                                                                                                                                    |
| `actor_type`, `actor_id`, `actor_email`, `actor_name`, `actor_role` | L'auteur : un `user`, une `api_key`, le `system` (purges de conservation, repères de licence) ou `anonymous` (une connexion échouée). Le rôle est `owner`, `member` ou `root`.                                                            |
| `auth_method`                                                       | `session`, `api_key`, `magic_code`, `sso` ou `root_password`.                                                                                                                                                                             |
| `target_type`, `target_id`, `target_name`                           | L'objet de l'action.                                                                                                                                                                                                                      |
| `ip_address`, `user_agent`, `request_id`                            | L'origine. L'identifiant de requête est renvoyé dans chaque réponse de l'API sous la forme `X-Request-ID`, ce qui permet de relier une entrée à une ligne de log de l'application.                                                        |
| `changes`                                                           | Avant/après des champs modifiés, sous la forme `{ "field": { "old": …, "new": … } }`. Les mots de passe, secrets, jetons et clés sont remplacés par `[redacted]` des deux côtés ; le fait qu'ils aient changé est conservé.               |
| `metadata`                                                          | Détails libres : la portée de la permission accordée, le nombre de contacts importés, la raison de l'échec d'une connexion.                                                                                                               |

## Ce qui est enregistré

Chaque route `POST /api/…` ci-dessous est enregistrée sous son propre nom. Les lectures ne sont pas enregistrées, à une exception près : l'export de contacts de la console demande la première page de `contacts.list` avec `export=true`, et cette requête est enregistrée comme `contacts.export`. Un client API qui parcourt lui-même la liste page par page fait des lectures ordinaires, qui ne sont pas enregistrées.

| Catégorie       | Actions                                                                                                                                                                                                |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| auth            | `user.signin`, `user.verify`, `user.rootSignin`, `user.oidc.exchange`, `user.oidc.callback`, `user.logout`, `setup.initialize`                                                                         |
| licence         | `licence.set`, `licence.recordingStopped`, `licence.recordingResumed`                                                                                                                                  |
| system          | `settings.update`                                                                                                                                                                                      |
| workspaces      | `workspaces.create`, `workspaces.update`, `workspaces.delete`, `workspaces.setBlogSettings`, `workspaces.setCustomFieldLabels`, `workspaces.setWebAnalyticsSettings`, `workspaces.setAuditLogSettings` |
| members         | `workspaces.inviteMember`, `workspaces.acceptInvitation`, `workspaces.joinInvitation`, `workspaces.deleteInvitation`, `workspaces.removeMember`, `workspaces.setUserPermissions`                       |
| api_keys        | `workspaces.createAPIKey`, `workspaces.connectZapier`                                                                                                                                                  |
| integrations    | `workspaces.createIntegration`, `workspaces.updateIntegration`, `workspaces.deleteIntegration`, `ses.enableTenantIsolation`, `webhooks.register`                                                       |
| webhooks        | `webhookSubscriptions.create`, `.update`, `.delete`, `.toggle`, `.regenerateSecret`                                                                                                                    |
| templates       | `templates.create`, `.update`, `.delete`, `templateBlocks.create`, `.update`, `.delete`                                                                                                                |
| broadcasts      | `broadcasts.create`, `.update`, `.schedule`, `.pause`, `.resume`, `.cancel`, `.delete`, `.retryFailed`, `.selectWinner`, `.sendToIndividual`                                                           |
| automations     | `automations.create`, `.update`, `.delete`, `.activate`, `.pause`                                                                                                                                      |
| lists, segments | `lists.create`, `.update`, `.delete`, `segments.create`, `.update`, `.delete`, `.rebuild`                                                                                                              |
| transactional   | `transactional.create`, `.update`, `.delete`                                                                                                                                                           |
| blog            | `blogPosts.*`, `blogCategories.*`, `blogThemes.*`                                                                                                                                                      |
| contacts        | `contacts.delete`, `contacts.import`, `contacts.export`, `customEvents.import`, `annotations.*`, `webAnalytics.backfillStart`, `.backfillCancel`                                                       |
| audit           | `auditLogs.export`, `audit.purged`                                                                                                                                                                     |

`GET /api/auditLogs.actions` renvoie ce catalogue, à partir duquel la console construit son filtre par action.

**Les échecs sont aussi enregistrés.** Une connexion pour une adresse inconnue, un code faux ou expiré, une tentative bloquée par la limite de fréquence : la réponse ne révèle rien, et l'entrée en donne la raison (`metadata.reason`). Une requête refusée par un contrôle de permission est enregistrée comme `denied`, avec la ressource et la permission qui manquaient ; une requête refusée par la licence est `denied`, avec la fonctionnalité qu'elle demandait.

**Non enregistré** : le plan de données (`contacts.upsert`, `customEvents.upsert`, `transactional.send`, `lists.subscribe` et les autres routes par contact), les lectures, les tests et aperçus, les endpoints de tâches internes, et la mise en pause automatique d'une newsletter par le disjoncteur. Ce dernier s'exécute sur le chemin d'envoi, qui ne contient aucun contrôle de licence.

## Filtres et export

Le champ de recherche accepte une adresse IP, l'email d'un auteur ou l'identifiant d'une cible, et indique sur lequel il cherche. Une adresse IP et un identifiant de cible doivent correspondre exactement ; un email correspond sur n'importe quelle partie.

À côté se trouvent des filtres sur la période (des dernières 24 heures aux 90 derniers jours, toute la période ou une plage personnalisée), l'auteur (vous-même, un membre ou une clé de l'espace dans la vue espace de travail ; n'importe quelle clé API, le système ou un visiteur non connecté dans les deux vues) et la ressource. **+ Filtre** ajoute l'action, le résultat, l'email de l'auteur, l'identifiant de la cible et l'adresse IP.

Chaque filtre est conservé dans le lien de la page : vous pouvez partager une vue filtrée ou l'ajouter à vos favoris. L'API accepte les mêmes filtres, plus `target_type`. La pagination se fait par curseur, du plus récent au plus ancien, et dans la vue espace de travail le bas de la liste indique combien de temps l'espace conserve ses entrées.

**Exporter** télécharge le filtre en cours en CSV ou NDJSON, jusqu'à 100 000 lignes. Un export qui atteint ce plafond se termine par une ligne de repère `export.truncated` portant `max_rows`, pour qu'un fichier tronqué ne passe jamais pour complet ; réduisez la plage de dates et exportez de nouveau.

L'export est lui-même enregistré comme `auditLogs.export`. Chaque entrée a un identifiant, et le bouton **Copier le lien** du panneau latéral donne un lien qui ouvre la page sur cette entrée, même si elle se trouve loin dans la liste.

## Conservation

Les entrées plus anciennes que la durée de conservation sont supprimées une fois par jour. La valeur par défaut est de **365 jours**. Un propriétaire d'espace de travail peut régler la durée propre à son espace dans Paramètres → Journal d'audit (0 conserve toutes les entrées indéfiniment, sinon de 30 à 3650 jours).

Un utilisateur root règle la valeur par défaut du déploiement dans les paramètres système ; elle s'applique aussi aux entrées de niveau déploiement et à celles des espaces de travail qui n'existent plus. Chaque purge qui a supprimé quelque chose est enregistrée comme `audit.purged`, avec le nombre d'entrées.

La conservation s'applique quel que soit l'état de la licence : la suppression des données ne dépend jamais de la licence.

## Intégrité

La table est **en ajout seul** : un trigger de base de données refuse chaque `UPDATE` et `TRUNCATE`, et chaque `DELETE` sauf ceux de la fonction de conservation. Aucun chemin de code de Notifuse ne réécrit l'historique, pas plus qu'une requête SQL égarée lancée avec son rôle de base de données.

Ce que cela n'empêche pas : le propriétaire de la base de données, ou un superutilisateur, peut désactiver le trigger ou supprimer la table. La garantie est « l'application ne peut pas modifier le journal », pas « personne ne le peut ». Si vous devez le prouver à un auditeur, sauvegardez la table hors de l'application, selon un calendrier qu'il accepte.

Les entrées sont stockées dans la base de données système, et non dans celle de l'espace de travail. Supprimer un espace de travail ne supprime donc rien du journal : la trace de qui l'a supprimé, et de ce que cette personne a fait avant, est conservée.

## API

Les quatre endpoints sont documentés dans la référence de l'API : [`auditLogs.list`](https://www.notifuse.com/docs/api-reference/audit-logs/list-audit-logs.md), [`auditLogs.get`](https://www.notifuse.com/docs/api-reference/audit-logs/get-an-audit-log-entry.md), [`auditLogs.actions`](https://www.notifuse.com/docs/api-reference/audit-logs/list-audit-actions.md) et [`auditLogs.export`](https://www.notifuse.com/docs/api-reference/audit-logs/export-audit-logs.md). Une clé API peut les appeler si elle a la permission Journaux d'audit en lecture : c'est ainsi qu'un SIEM récupère le journal à intervalles réguliers.

La durée de conservation se règle par l'API avec [`workspaces.setAuditLogSettings`](https://www.notifuse.com/docs/api-reference/audit-logs/set-the-workspace-audit-log-retention.md), que seul un propriétaire d'espace de travail peut appeler : aucune permission ne donne ce droit.
