# Événements tracés et conservation

> Ce que contient un événement du journal d'audit, ses collections et ses niveaux de gravité, et comment Wakastart le protège, le vérifie et le conserve.

Un événement d'audit répond à quatre questions : qui, quoi, quand, d'où. Wakastart l'écrit au moment de l'action, lui attribue une empreinte qui permet de détecter une modification, et le garde trois ans.

## Définition

Un événement contient :

| Élément | Exemple |
|---|---|
| Date et heure | `2026-10-23T08:12:04.511Z` |
| Action | `USER_CREATE`, `USER_INVITED`, `USER_PROFILES_CHANGED`, `API_KEY_CREATED` |
| Gravité | `critical`, `error`, `alert`, `warning` ou `info` |
| Origine | Le service qui a écrit l'événement |
| Auteur | L'utilisateur, avec son niveau d'administration, ou la clé API |
| Organisation | Les WID du propriétaire, du réseau et du client |
| Application | Le WID de l'application concernée |
| Adresse IP | L'adresse d'où venait la requête |
| Description et informations | Le détail de l'action, au format JSON |

Le journal d'audit n'est pas un journal technique : il ne contient pas les logs de vos services. Ceux-ci se consultent dans [Supervision et logs](/v1.0/supervision).

## Comment ça marche

### Ce qui est tracé

Wakastart trace notamment :

- les comptes : création, modification, désactivation, réactivation, suppression, import ;
- les invitations : envoi, acceptation ;
- les droits : création de profils, changements de profils d'un utilisateur, équipes et membres ;
- les clés API : création et révocation ;
- l'organisation : création de propriétaires, de réseaux et de clients ;
- la consultation elle-même : l'accès au tableau de bord et au journal d'audit est tracé.

### Trois collections

| Collection | Libellé de la console | Contenu |
|---|---|---|
| `user` | User | Les actions d'un utilisateur authentifié. Collection affichée par défaut. |
| `api` | API | Les appels entre services de la plateforme |
| `open` | Open (Public) | Les opérations enregistrées sans utilisateur authentifié |

### Protection des données

- **Chiffrement.** Les données sensibles d'un événement sont chiffrées selon leur catégorie : sécurité, données personnelles, données de santé. Les données de santé ne sont affichées qu'aux utilisateurs qui ont un rôle HDS adapté.
- **Intégrité.** Chaque événement reçoit une empreinte cryptographique, qui permet de détecter une modification après coup. Wakastart en contrôle chaque jour un échantillon ; un événement ou un lot d'événements peut aussi être vérifié à la demande.
- **Archivage.** Chaque semaine, les événements qui approchent de la fin de leur durée de conservation sont archivés : l'archive est chiffrée (AES-256-GCM) et accompagnée d'une empreinte de contrôle. Wakastart exporte aussi régulièrement le journal, chiffré, vers un stockage objet distinct.

### Conservation

Les événements restent consultables **3 ans** dans le journal.

### Cloisonnement

Vous ne lisez que les événements de votre organisation. Dans la console, un administrateur voit les événements liés à son propre compte. Par l'API publique, la lecture est limitée à votre client (à votre réseau pour un administrateur réseau, aux clients de l'application pour un propriétaire) et toujours à l'application du jeton ou de la clé.

## Exemples

- **Contrôle interne.** Chaque mois, le serveur de l'éditeur extrait par l'API publique les changements de profils (`USER_PROFILES_CHANGED`) de son client.
- **Vérification personnelle.** Un administrateur retrouve dans la console ses propres actions de la veille, filtrées sur la période.
- **SIEM.** Le serveur de l'éditeur récupère les événements de son application par l'API publique et les envoie dans son outil de corrélation.

## Pour aller plus loin

- [Consulter le journal dans la console](/v1.0/journal-d-audit/consulter-le-journal)
- [Lire le journal par l'API publique](/v1.0/journal-d-audit/lire-le-journal-par-l-api)
- [Référence du journal d'audit](/v1.0/journal-d-audit/reference)
