# Référence du journal d'audit

> Champs d'un événement d'audit, collections, niveaux de gravité, durées de conservation et opération de l'API publique.

Cette page décrit le format des événements d'audit. L'endpoint est détaillé dans la [référence API du journal d'audit](/v1.0/reference-api/audit).

## Événement

| Champ | Type | Description |
|---|---|---|
| `id` | chaîne | Identifiant de l'événement (24 caractères hexadécimaux) |
| `timestamp` | date | Date et heure de l'événement |
| `context.origin` | chaîne | Service qui a écrit l'événement (console : **Service origine**) |
| `context.app-id` | chaîne | WID de l'application |
| `context.action` | chaîne | Code de l'action (console : **Action**) |
| `context.severity` | énumération | Gravité (console : **Severite**) |
| `description` | chaîne | Description lisible |
| `info` | chaîne | Détail au format JSON (texte) |
| `ip` | chaîne | Adresse IP d'origine (console : **Adresse IP**) |
| `user-id` | chaîne | Auteur de l'action (console : **Utilisateur**) |
| `admin-level` | chaîne | Niveau d'administration de l'auteur (console : **Niveau admin**) |
| `partner-wid`, `network-wid`, `customer-wid` | chaînes | Organisation concernée |
| `api-id` | chaîne | Clé API ou service à l'origine de l'appel |
| `hds` | chaîne | Données de santé chiffrées ; sans rôle HDS adapté, la valeur est masquée |

## Gravité

| Valeur | Libellé de la console |
|---|---|
| `critical` | Critical |
| `error` | Error |
| `alert` | Alert |
| `warning` | Warning |
| `info` | Info |

## Collections

| Valeur | Libellé de la console | Contenu |
|---|---|---|
| `user` | User | Actions d'utilisateurs authentifiés (par défaut) |
| `api` | API | Appels entre services |
| `open` | Open (Public) | Opérations sans utilisateur authentifié |

## Conservation et intégrité

| Propriété | Valeur |
|---|---|
| Durée de consultation | 3 ans |
| Empreinte d'intégrité | une par événement |
| Contrôle d'intégrité | quotidien, par échantillonnage ; vérification d'un événement ou d'un lot à la demande |
| Archivage | hebdomadaire, archive chiffrée (AES-256-GCM) avec empreinte de contrôle |

## Écran de la console

| Écran | Chemin | Accès |
|---|---|---|
| **Audit Logs** | **Sécurité** > **Audit Logs** | Administrateur client avec `audit.read` (profil **Auditeur**). Affiche les événements liés à votre compte. |

## Opération de l'API publique

| Opération | Méthode et chemin | Paramètres | Accès |
|---|---|---|---|
| Lister les événements | `GET https://api.wakastart.app/api/audit-logs` | `action`, `userId`, `page`, `limit` (1 à 100, 20 par défaut) | Tout appelant authentifié ; limité à l'application de l'appelant et à son client (son réseau pour un Administrateur réseau, toute l'application pour un Propriétaire) |

Réponse : `{ "data": [...], "total", "page", "limit", "totalPages" }`.
