Audit
Lire par l'API publique le journal d'audit des actions menées dans votre organisation et votre application.
This page has not been translated yet and is shown in French.
Wakastart trace les actions sensibles (connexions, créations et modifications d'utilisateurs, d'équipes, de profils, invitations…) dans le journal d'audit. L'API publique en donne une lecture limitée à votre périmètre ; l'écran complet, avec la vérification d'intégrité et l'export, est décrit dans Journal d'audit.
Accès : tout appelant authentifié par jeton Keycloak, jeton enrichi ou clé API. Aucun droit ni niveau d'administration particulier n'est exigé.
Les événements renvoyés sont toujours limités à l'application de l'appelant et à son périmètre : toute l'application pour un Propriétaire, son réseau pour un Administrateur réseau, son client sinon.
L'objet Événement d'audit
| Champ | Type | Description |
|---|---|---|
id | chaîne (24) | Identifiant de l'événement |
timestamp | chaîne ISO 8601 | Date de l'action |
context.origin | chaîne | Service ou écran à l'origine de l'action |
context.app-id | chaîne | Application concernée |
context.action | chaîne | Action tracée, par exemple USER_INVITED ou USER_DISABLED |
context.severity | chaîne | critical, error, alert, warning ou info |
description | chaîne | Description lisible de l'action |
info | chaîne | Détails complémentaires |
ip | chaîne | Adresse IP de l'auteur |
user-id | chaîne | Auteur de l'action |
admin-level | chaîne | Niveau d'administration de l'auteur |
partner-wid, network-wid, customer-wid | chaîne | Propriétaire, réseau et client concernés |
partner-id, network-id, customer-id | UUID | Mêmes rattachements, en identifiants techniques |
Les champs absents d'un événement sont omis.
Lister les événements
/api/audit-logs| Paramètre de requête | Type | Défaut | Description |
|---|---|---|---|
page | entier ≥ 1 | 1 | Page |
limit | entier, 1 à 100 | 20 | Taille de page |
action | chaîne | — | Ne garde que cette action |
userId | UUID, WID ou identifiant de 24 caractères | — | Ne garde que les actions de cet auteur |
curl -s "https://api.wakastart.app/api/audit-logs?action=USER_INVITED&limit=50" \
-H "Authorization: Bearer $ACCESS_TOKEN"Réponse 200
{
"data": [
{
"id": "6718c2a9f1e2d3c4b5a69788",
"timestamp": "2026-10-23T09:02:11.000Z",
"context": { "origin": "invitations", "app-id": "EXAPP1", "action": "USER_INVITED", "severity": "info" },
"description": "Invitation envoyée à chloe@clinique-exemple.fr",
"ip": "203.0.113.24",
"user-id": "6c1f2a9e-4b1d-4e0b-9a51-2f6c3d7e8a10",
"admin-level": "CUSTOMER_ADMIN",
"network-wid": "EXNET1",
"customer-wid": "EXCLI1"
}
],
"total": 1,
"page": 1,
"limit": 50,
"totalPages": 1
}La réponse de cette liste est à plat (total, page, limit, totalPages au même niveau que data), contrairement aux listes de l'organisation (voir Pagination).
Erreurs
| Statut | Message | Cause |
|---|---|---|
401 | Token enrichi valide requis — authentifiez-vous avec un Bearer token ou une clé API valide | Aucune identité valide |
403 | Impossible de déterminer le scope tenant pour la consultation des logs d'audit | L'appelant n'est rattaché à aucun client, réseau ni propriétaire |
503 | Service in degraded mode: MongoDB is not connected | Journal momentanément indisponible |
Les événements sont conservés 3 ans.