# Journaux d'audit

Le journal d'audit infalsifiable : ce qui est enregistré, comment le rechercher et l'exporter, et comment vérifier un export scellé.

Le journal d'audit est l'enregistrement permanent de la plateforme pour chaque action significative. Chaque entrée consigne *ce qui s'est passé*, *qui l'a déclenché*, *qui ou quoi était concerné* et *quand*, ainsi que l'adresse IP d'origine, l'emplacement approximatif et l'agent utilisateur. Les entrées sont uniquement ajoutées, jamais modifiées ni supprimées manuellement, et chaque entrée scellée est chaînée et signée cryptographiquement, de sorte qu'un tiers peut prouver qu'un journal exporté n'a pas été altéré.

Vous trouvez le journal sous **Journal d’audit → Journaux** dans l'Admin Console.

## Ce qui est enregistré

Le journal couvre toute l'étendue de l'activité de la plateforme. Dans les grandes lignes, les entrées relèvent des domaines suivants :

- **Authentification** : connexions réussies et échouées, échanges de jetons de single sign-on, connexions fédérées (sociales/entreprise), authentification silencieuse, step-up et réauthentification, déconnexion et déconnexion back-channel.
- **Authentification multifacteur** : enrôlement de facteurs, vérifications réussies et échouées, utilisation de codes de récupération, suppression de facteurs et réinitialisations MFA initiées par un administrateur.
- **Cycle de vie des utilisateurs** : création de compte, invitation, modifications de profil, changements d'e-mail/téléphone/nom d'utilisateur/mot de passe, activation/désactivation/déverrouillage de compte et suppression. Voir [Cycle de vie des utilisateurs](https://dts-identity.com/fr/docs/directories/user-lifecycle.md).
- **Autorisation** : accès aux applications accordé et révoqué, modifications des appartenances aux rôles et aux groupes, attributions d'administrateur d'organisation et revues d'accès.
- **Administration et configuration** : modifications des applications, répertoires, connexions, zones réseau, workflows d'approbation, workflows de certification, API et clés d'API, organisations et paramètres système.
- **Incidents de sécurité** : tentatives avec des mots de passe compromis, détection de force brute, accès depuis une région interdite, connexion depuis un nouvel appareil et dépassements de limites de débit.
- **Événements d'appareils** : enregistrement et suppression, commandes envoyées à un appareil ou mises en file d'attente, et transitions en ligne/hors ligne du connecteur.
- **Événements de session** : sessions terminées par le système, avec enregistrement de la durée totale de la session achevée.
- **Provisionnement** : opérations de provisionnement SCIM sortant et leurs résultats.
- **Approbations** : création et événements de cycle de vie des workflows d'approbation, ainsi que campagnes de certification des accès et décisions de revue.
- **Usurpation d'identité (impersonation)** : moment où un administrateur commence et cesse d'agir au nom d'un autre utilisateur ou d'une autre organisation.

Pour la liste complète et détaillée avec les niveaux de gravité, voir [Types d'événements d'audit](https://dts-identity.com/fr/docs/reference/audit-event-types.md).

## Le modèle d'acteur : qui a fait quoi à qui

Chaque entrée distingue le **sujet** (qui ou quoi l'événement *concerne*) de l'**acteur** (qui l'a *déclenché*). C'est ce qui vous permet de répondre à la question « que s'est-il passé pour l'utilisateur X ? » en recherchant sur le sujet, tout en voyant qui a agi.

- Pour les actions en **libre-service** (un utilisateur qui modifie son propre mot de passe, qui se connecte), le sujet et l'acteur sont la même personne.
- Pour les actions **d'un administrateur sur un utilisateur** (un admin qui attribue un rôle à quelqu'un, qui désactive un compte), le sujet est l'utilisateur concerné et l'administrateur agissant est enregistré à côté.
- Pour les **modifications du système ou d'objets** (créer une application, modifier une politique), l'administrateur agissant est l'utilisateur de l'entrée, et l'objet modifié est nommé dans l'entrée.
- Pour les actions **pilotées par une machine** via l'API, l'acteur est enregistré en tant que client (machine) plutôt qu'en tant que personne, avec le canal par lequel il est passé (Admin Console, API, provisionnement, connecteur ou système).

La vue détaillée de chaque entrée affiche l'objet concerné, les champs modifiés le cas échéant, l'IP/l'emplacement/l'agent utilisateur et le contexte complet de l'événement.

## Rechercher et filtrer

Le journal s'ouvre sur les entrées les plus récentes et charge les plus anciennes au fil du défilement. La barre d'outils au-dessus de la liste est la même que celle des listes d'utilisateurs et d'appareils :

- **Règles de filtre** : ajoutez une règle par champ et combinez-les : **Type d'événement** (un ou plusieurs types du catalogue), **Catégorie** et **Gravité** (des groupes entiers de types à la fois), **Horodatage** (une plage de/à avec l'heure, dans votre propre fuseau horaire ; laissez un côté vide pour une plage ouverte), **Pays** et **Ville** (d'après la géolocalisation de l'entrée), **Adresse IP**, **E-mail de l'utilisateur**, **Nom d'utilisateur**, **Application** et **Répertoire** (choix dans la liste), **Organisation** et **Description**. Les règles de texte proposent *contient*, *est*, *commence par* et leurs négations ; les règles de liste proposent *est l'un de* / *n'est aucun de*.
- **Recherche en texte libre** : correspondance avec la description, l'adresse IP, le nom/nom d'utilisateur/e-mail de l'utilisateur sujet ou le nom de l'application. Appuyez sur Entrée pour appliquer.
- **Colonnes** : affichez ou masquez des colonnes et réorganisez-les par glisser-déposer. L'adresse IP, l'emplacement, la gravité, la catégorie, le répertoire et l'organisation sont disponibles en plus de l'horodatage, de l'événement, de l'application et de l'utilisateur affichés par défaut.
- **Vues** : les vues standard à gauche sont des filtres prêts à l'emploi : *Attaques* (force brute, verrouillages, mots de passe compromis, région interdite, emplacement inhabituel), *Connexions échouées*, *Sécurité et détection d'anomalies*, *Configuration et administration du système* et *Erreurs*. Enregistrez votre propre combinaison de règles et de colonnes en tant que vue nommée, ou copiez l'URL : chaque filtre figure dans la barre d'adresse.
- **Exporter en CSV** : télécharge la liste filtrée dans l'ordre des colonnes visibles (menu de partage), les plus récentes en premier et plafonnée à 50 000 entrées ; la boîte de dialogue le signale lorsque la vue en contient davantage, auquel cas restreignez le filtre pour tout couvrir.

La liste fonctionne également **en direct** : activez le **Mode direct** et les nouvelles entrées arrivent automatiquement au fur et à mesure, et le graphique d'activité s'actualise, sans rechargement de la page. C'est utile lorsque vous reproduisez un problème ou suivez le déroulement d'un incident. Le graphique et le flux en direct suivent le filtre actif.

Ouvrez n'importe quelle entrée pour afficher son panneau de détail complet, y compris le contexte brut de l'événement.

Quelques exemples concrets de combinaison de filtres :

- **Toutes les connexions échouées depuis une IP sur une période** : choisissez la vue *Connexions échouées*, ajoutez une règle **Horodatage** avec la période et une règle **Adresse IP**.
- **Tout ce qui provient d'un pays** : ajoutez une règle **Pays** (par exemple après que la carte des attaques du tableau de bord de protection a révélé une origine inattendue) ; ajoutez **Horodatage** pour restreindre au jour concerné.
- **Tous les événements MFA d'un utilisateur** : ajoutez une règle **Type d'événement** avec les événements multifacteurs et une règle **E-mail de l'utilisateur**.
- **Toutes les modifications de configuration effectuées par un admin** : choisissez la vue *Configuration et administration du système* et recherchez le nom de l'admin.
- **Tout ce qui est arrivé à un appareil** : ouvrez l'onglet **Historique** de l'appareil. Il répertorie les entrées concernant cet appareil (commandes, exécutions de mises à jour, approbation, utilisateurs attribués, violations de politique), avec sa propre recherche et ses propres filtres par type et par date ; la liste des types n'affiche que les types présents pour l'appareil. Il couvre les entrées écrites depuis l'introduction de l'onglet et est affiché aux admins autorisés à lire l'intégralité du journal d'audit.

> **Remarque :** Les secrets à usage unique qui transitent dans des liens (jetons de réinitialisation de mot de passe, codes de vérification d'e-mail) sont automatiquement masqués dans les entrées du journal, de sorte qu'ils ne sont jamais conservés dans la piste d'audit.

## Scellement infalsifiable

Au-delà de son fonctionnement en ajout seul, le journal d'audit est **scellé** afin que toute falsification puisse être détectée a posteriori :

1. **Chaîne de hachage.** Chaque entrée scellée reçoit un numéro de séquence et un hash calculé sur le contenu de l'entrée *et* sur le hash de l'entrée précédente (un HMAC dont la clé est un secret propre au déploiement). Comme chaque hash intègre le précédent, modifier, supprimer ou réordonner une entrée rompt la chaîne à partir de ce point.
2. **Signature cryptographique.** Chaque entrée scellée est en outre signée avec une clé Ed25519. La **clé publique de vérification** correspondante est publiée, de sorte que quiconque la détient peut vérifier une signature sans accès à la plateforme.

Le scellement s'effectue en arrière-plan et ne bloque ni ne perd jamais une écriture dans le journal.

Vous n'avez pas besoin d'exporter pour repérer un problème : dès qu'une entrée est scellée, sa vue détaillée affiche ses métadonnées de scellement (numéro de séquence, hash, hash précédent) ainsi qu'un **indicateur de validité du hash**. Une coche verte signifie que le hash recalculé de l'entrée correspond toujours ; un contrôle en échec est signalé directement dans la console, de sorte qu'un maillon rompu de la chaîne est visible sur place et pas seulement au moment de l'export.

> **Ce que cela prouve et ne prouve pas.** Le scellement vous permet, à vous ou à un auditeur externe, de prendre un lot **exporté** d'entrées de journal et de prouver ultérieurement qu'il n'a pas été modifié, réordonné ni tronqué après l'export, et qu'il a été signé par cette plateforme. Il est conçu pour *exporter des journaux ailleurs et prouver leur intégrité plus tard*. Il ne constitue pas une garantie de non-répudiation vis-à-vis de l'opérateur de la plateforme.

### Vérifier un journal exporté

Pour vérifier de manière indépendante un export de journal :

1. **Exportez les entrées.** Récupérez les entrées du journal (via l'API de journaux de la plateforme, qui inclut les métadonnées de scellement, à savoir numéro de séquence, hash précédent, hash et signature, à côté du contenu de chaque entrée).
2. **Obtenez la clé publique de vérification.** La plateforme publie la clé publique Ed25519 utilisée pour signer les entrées ; récupérez-la une fois et conservez-la.
3. **Vérifiez.** La vérification parcourt les entrées exportées dans l'ordre des séquences et exécute trois contrôles successifs :
   - une **analyse structurelle préalable** qui confirme que les numéros de séquence sont contigus et que le hash précédent enregistré de chaque entrée correspond à l'entrée qui la précède (aucun secret n'est nécessaire) ;
   - un **recalcul du hash** qui redérive le hash de chaîne de chaque entrée à partir de son contenu et le compare à la valeur stockée ;
   - une **vérification de signature** qui contrôle la signature Ed25519 de chaque entrée par rapport à la clé publique publiée.

   Si les entrées ont été modifiées, réordonnées ou si une fin a été tronquée, l'un de ces contrôles échoue et indique précisément où.

L'Admin Console affiche la clé publique publiée et l'extrémité actuelle de la chaîne, afin que vous puissiez confronter un export au journal en direct.

## Historique des modifications par objet

Indépendamment du journal d'audit central, certains enregistrements conservent leur **propre historique de modifications versionné** : un avant/après au niveau des champs montrant l'évolution de cet objet précis. Sur la page de détail d'un utilisateur, ouvrez **Afficher l'historique** pour voir chaque version avec les champs ajoutés, supprimés ou modifiés (ancienne valeur vers nouvelle valeur) et la date.

Utilisez-le lorsque votre question est *« comment cet enregistrement en est-il arrivé à son état actuel ? »* : il se lit comme une chronologie de différences claire pour cet objet. Utilisez le journal d'audit central lorsque votre question est *« qui a fait quoi, sur l'ensemble, pendant cette période ? »*. Les deux se complètent : le journal d'audit est l'enregistrement transversal ; l'historique des modifications raconte l'histoire de chaque objet.

## Conservation

La durée de conservation des entrées dépend de votre niveau d'abonnement :

| Niveau | Conservation du journal d'audit |
|---|---|
| Trial | 7 jours |
| Essential | 30 jours |
| Advanced | 90 jours |
| Pro | jusqu'à 365 jours |

Les entrées plus anciennes sont supprimées automatiquement dès qu'elles dépassent la période de conservation. Si vous devez conserver des enregistrements plus longtemps que votre niveau ne le permet, exportez-les régulièrement : les lots exportés et scellés restent vérifiables indéfiniment. Consultez [Plans et add-ons](https://dts-identity.com/fr/docs/getting-started/plans-and-addons.md) pour la matrice complète.

## Export

Les entrées peuvent être exportées via l'API de journaux de la plateforme à des fins d'archivage, d'intégration dans un système en aval ou de vérification indépendante. L'export inclut le contenu de chaque entrée **et** ses métadonnées de scellement, ce qui rend possible un contrôle d'intégrité ultérieur.

L'export se fait **à la demande** : vous récupérez les entrées lorsque vous en avez besoin. Il n'existe pas de cible de streaming en direct : la plateforme n'envoie pas de flux continu vers un collecteur de journaux externe. Si vous conservez des enregistrements dans un système externe, planifiez un export périodique et **exportez toujours avant que les entrées ne sortent de la période de conservation de votre niveau** (voir Conservation ci-dessus) : une fois supprimées, elles disparaissent du journal en direct, même si tout lot scellé déjà exporté reste vérifiable.

## Voir aussi

- [Types d'événements d'audit](https://dts-identity.com/fr/docs/reference/audit-event-types.md) : le catalogue complet des événements enregistrés.
- [Problèmes](https://dts-identity.com/fr/docs/monitoring/issues.md) : anomalies système récurrentes, suivies séparément.
- [Cycle de vie des utilisateurs](https://dts-identity.com/fr/docs/directories/user-lifecycle.md) : les changements d'état des utilisateurs qui apparaissent dans le journal.
