Journaux d’audit

Who can do it : admins d’entreprise
Which plans : forfait Enterprise
Which platforms : Navigateur

Les journaux d’audit permettent aux administrateurs de l’organisation disposant des privilèges appropriés de suivre l’activité des utilisateurs dans leur organisation Miro. Les journaux sont extrêmement utiles pour enquêter sur un problème ou obtenir un rapport détaillé sur des événements importants (par exemple, les modifications apportées aux paramètres de sécurité globaux, les invitations de nouveaux utilisateurs ou la création de nouveaux tableaux).

✏️ Actuellement, les événements sont enregistrés à partir du moment où l’abonnement Enterprise est créé et sont stockés pendant 180 jours par défaut :
a) Si vous passez à un forfait Enterprise depuis un autre forfait, les événements seront enregistrés dès le moment du changement.
b) Si vous migrez certaines équipes vers l’abonnement Enterprise, leurs données ne seront enregistrées que lorsqu’elles feront partie de l’abonnement.

Accès aux journaux d’audit

Pour accéder aux journaux d’audit, procédez comme suit :

1. Rendez-vous dans Paramètres de l’entreprise.
2. Dans le panneau de gauche, cliquez sur Sécurité > Journaux d’audit.
3. Vous pouvez filtrer les journaux d’audit en choisissant une Plage de dates, un ou plusieurs Acteurs (y compris des applications et des agents IA agissant au nom d’un utilisateur), une ou plusieurs Catégories d’événements, un ou plusieurs Événements spécifiques, et un ou plusieurs Objets affectés.

Cliquez sur le bouton Afficher les événements pour visualiser les événements correspondant à vos critères de filtrage. L’heure est affichée au format ISO 8601, dans le fuseau horaire local. Vous pouvez consulter les détails d’un événement particulier en cliquant sur les trois points de la colonne Détails.

✏️ Vous pouvez visualiser les événements jusqu’à la période de conservation du journal d’audit de votre organisation (jusqu’à 365 jours).

Exporter les journaux d’audit

Vous pouvez exporter les journaux d’audit au format CSV.

Dans le fichier d’exportation CSV, la date et l’heure de l’événement sont fournies au format ISO 8601, fuseau horaire UTC. Il n’y a pas de limite au nombre d’enregistrements pouvant être exportés en une fois ; toutefois, plus vous exportez de données, plus il faut de temps pour préparer le fichier en vue du téléchargement. N’oubliez pas non plus que les applications courantes permettant de travailler avec des tables ont leurs limites quant au volume de données qu’elles peuvent ouvrir. Le fichier exporté reflète les filtres que vous avez appliqués, y compris le filtre Objet affecté.

Pour exporter les journaux d’audit, cliquez sur le bouton Exporter au format CSV.

La barre contenant les détails de votre fichier d’exportation apparaîtra ci-dessous. Lorsque le fichier est prêt à être téléchargé, vous pouvez cliquer sur le bouton Télécharger CSV. Le fichier sera disponible au téléchargement pendant 24 heures.

✏️ Actuellement, un seul fichier d’exportation peut être téléchargé par organisation à la fois. En cliquant sur le bouton Exporter vers CSV, vous remplacerez le fichier d’exportation actuel.

Accéder aux journaux d’audit via l’API

Les admins peuvent utiliser l’API du journal d’audit ou les intégrations SIEM prises en charge pour accéder de manière programmatique aux données du journal d’audit et les collecter.

L’API prend en charge les mêmes filtres que l’interface : Acteur, catégorie d’événement, événement et objet affecté, chacun acceptant plusieurs valeurs. Vous pouvez récupérer l’historique complet du journal d’audit de votre organisation via l’API.

Retrait de l’Audit Logs API v1

L’Audit Logs API v1 a été retirée. Si vous avez une intégration personnalisée basée sur v1 (GET /v1/audit/logs), migrez-la vers v2 (GET /v2/audit/logs). L’authentification et les paramètres de fenêtre temporelle restent inchangés. En revanche, la pagination, le format de réponse et certains noms de champs diffèrent ; consultez la référence de l’API pour plus de détails. Si vous utilisez une application fournie par Miro ou un connecteur du Marketplace (par exemple, l’application Miro pour Splunk ou Microsoft Sentinel), mettez-la à jour vers la dernière version, qui prend déjà en charge v2.

Modifications notables dans la réponse v2 :

• La pagination est basée sur un curseur (une valeur de curseur opaque) au lieu d’un offset ; il n’existe pas de nombre total d’entrées.
• createdBy.id est renvoyé sous forme de chaîne (auparavant un nombre).
• Chaque événement inclut un champ category au niveau supérieur.
• Les identifiants d’événement sont des chaînes UUID (auparavant un suffixe numérique) ; traitez-les comme des valeurs opaques.
• createdAt reflète le moment où l’événement a été stocké plutôt que le moment exact de l’action (décalage typique de quelques secondes).
• Les champs details utilisent le camelCase (par ex. organizationId), les grands nombres sont sérialisés en chaînes, les horodatages utilisent ISO 8601, et les clés ayant la valeur null sont omises.
• Pour les actions effectuées par une application, une intégration ou un agent IA au nom d’un utilisateur, l’objet actor inclut un champ onBehalfOf identifiant cet utilisateur.
• Le nom de l’acteur pour les visiteurs déconnectés est désormais "Visitor" (auparavant "Guest").
• Les événements liés au tableau font référence à la boardKey publique plutôt qu’à un identifiant numérique interne.
• Les types et catégories d’événements qui faisaient référence à "project" utilisent désormais "space" (par exemple, project_created est désormais space_created) ; ceci s’applique rétroactivement aux événements historiques récupérés via v2.

Suppression des journaux d’audit

Les admins peuvent définir une politique de conservation des journaux d’audit. Vous pouvez choisir entre 30, 90, 180 ou 365 jours.

⚠️ Une fois les journaux d’audit supprimés, ils ne peuvent pas être récupérés.

✏️ La conservation indéfinie des journaux d’audit a été supprimée.

Pour définir une période de suppression, procédez comme suit :

1. Rendez-vous dans Paramètres de l’entreprise.
2. Dans le panneau de gauche, cliquez sur Sécurité > Journaux d’audit.
3. Sous Journaux d’audit, cliquez sur l’onglet Paramètres.
4. Choisissez une option dans la liste déroulante. Il vous sera demandé de confirmer votre choix.

Les événements dans les journaux d’audit

Les journaux d’audit comprennent des enregistrements concernant les catégories d’événements suivantes :

FAQ