Journal d'audit : qui a modifié quoi et quand

À quoi cela sert

Le journal d'audit montre qui a modifié quoi et quand. Il enregistre automatiquement chaque action d'écriture provenant de l'interface d'administration, de l'API publique, du libre-service des utilisateurs finaux (y compris les portails des agents et des standardistes) ainsi que des tâches d'arrière-plan et de la file d'attente. Pour chaque connexion CUCM, les modifications effectuées directement sur le CUCM s'y ajoutent.

Vous en avez besoin pour remonter d'un incident à une modification (« le téléphone ne sonne plus depuis hier »), comme preuve pour l'audit et la protection des données, et pour les cas de support. Les connexions à EasyUC figurent aussi dans le journal, réussies ou échouées, sans le mot de passe. Les simples accès en lecture ne sont pas journalisés ; les exports le sont.

Chaque ligne correspond à une action, par exemple la modification d'un terminal. Ce qui a réellement été écrit, comme les appels AXL individuels vers le CUCM, est listé sous forme de modifications individuelles dans la vue de détail. Les mots de passe, les codes PIN, les clés et le contenu des requêtes ne sont jamais enregistrés.

Prérequis

Rôle de page ROLE_APP_VIEW_LOG_PAGE pour l'entrée de menu et ROLE_APP_LIST_LOG (« Logs: classic list and audit log » dans l'éditeur de rôles) pour la liste et les détails.
Pour l'onglet Technical et les adresses IP dans l'export : ROLE_APP_VIEW_AUDIT_TECHNICAL. Attribuez-le de façon ciblée en raison des adresses IP.
Pour Export et le journal de support : ROLE_APP_EXPORT_AUDIT.
Pour Settings (conservation, sources) : ROLE_APP_EDIT_AUDIT_SETTINGS.
Vous attribuez les rôles dans l'éditeur d'utilisateurs sous Administration → Access & Appearance → Administrators & Roles, zone Logs.
Les administrateurs limités à des sites ne voient que les entrées de leurs sites et leurs propres actions. Ils ne voient pas les entrées sans site.
Pour les modifications effectuées directement sur le CUCM, le CUCM change log doit être activé sur la connexion CUCM.

Pas à pas : retrouver une modification

Sélectionnez dans l'en-tête la connexion CUCM à laquelle l'objet appartient.
Ouvrez Logs → EasyUC Logs. La page s'intitule Audit log.
Saisissez ce que vous savez dans le champ de recherche : nom de terminal ou adresse MAC, numéro de téléphone, ID d'utilisateur, adresse e-mail ou nom de l'acteur. Sous le champ, « Searching as: … » indique comment la saisie a été interprétée.
Cliquez sur Search.
Sous Time range, choisissez Today, Last 7 days, Last 30 days ou Custom. Par défaut : les 7 derniers jours.
Utilisez Add filter pour ajouter d'autres filtres : Source, Result, Type of change, Object type, Action, Performed by ou Location. Chaque filtre apparaît sous forme de pastille et peut être retiré individuellement.

Vue originale pour cette procédure Aller à l’étape 6
Au-dessus des résultats, filtrez les entrées par période, source et résultat. La liste contient de véritables entrées système du laboratoire. Ouvrez une entrée pertinente pour examiner la modification en détail.

EasyUC · Environnement de test/démonstration Capture de l’interface en allemand
Filtrer le journal des modifications

Journal original du laboratoire avec filtres de date, source et résultat. Les entrées visibles proviennent d’activités existantes, surtout de collectes en arrière-plan ; aucune entrée n’a été créée pour la capture.
Cliquez sur la ligne dans la liste. Le panneau latéral Details s'ouvre.
Dans l'onglet Changes, lisez Before et After pour chaque champ.
Ouvrez l'onglet Involved pour voir les modifications individuelles avec résultat et texte d'erreur, ainsi que tous les objets concernés.
Si nécessaire, cliquez sur Show all entries of this operation pour voir toutes les étapes de la même action, y compris celles qui se sont poursuivies en arrière-plan.
Load more récupère les correspondances plus anciennes. Reset all filters rétablit la vue initiale.

Pas à pas : exporter et créer un journal de support

Réglez la recherche et les filtres de façon que la liste affiche les entrées souhaitées.
Cliquez sur Export en haut à droite et choisissez Export as CSV ou Export as Excel file (XLSX).
S'il y a plus de correspondances que le maximum autorisé, la page propose de n'exporter que les entrées les plus récentes.
Pour un cas de support : reproduisez le problème, puis cliquez sur Last 5 minutes ou Last 10 minutes dans l'encadré Download support log. Vous recevez au format CSV toute l'activité EasyUC et CUCM de cette fenêtre de temps.

Pas à pas : régler la conservation et les sources

Cliquez sur Settings en haut à droite. La boîte de dialogue Retention and sources s'ouvre.
Saisissez les durées sous Keep EasyUC entries (months) et Keep CUCM entries (months).
Saisissez la durée applicable aux adresses IP sous Remove IP addresses after (days).
Sous Recorded sources, activez ou désactivez Record pour chaque source.
Cliquez sur Save. La modification prend effet dans tous les services au plus tard après 30 secondes.

Champs et options

Champs et options
Champ / action	Signification et utilisation
Search field	Une adresse MAC ou un nom SEP trouve des terminaux. Des chiffres ou `+` trouvent des numéros : `4711` trouve les numéros exacts ou se terminant par 4711, `4711` commence par, `4711` se termine par. `@` trouve les e-mails et les ID d'utilisateur. Toute autre saisie correspond au début des noms, des descriptions, des utilisateurs et des acteurs.
Time range	Today, Last 7 days (par défaut), Last 30 days ou personnalisé, 366 jours au maximum.
Show possible echoes of own changes	Lorsqu'EasyUC modifie quelque chose sur le CUCM, le CUCM renvoie cette modification. Les échos qui ne peuvent pas être attribués avec certitude sont enregistrés, mais masqués par défaut. Cette option les affiche.
Export	CSV jusqu'à 200 000 lignes, Excel jusqu'à 10 000 lignes, chacun avec les filtres actuels. CSV avec séparateur `;` et UTF-8. Chaque export est lui-même consigné dans le journal d'audit.
Keep EasyUC entries (months)	Par défaut 12, de 1 à 120 autorisé.
Keep CUCM entries (months)	S'applique aux sources CUCM direct et CUCM audit log. Par défaut 3, de 1 à 120 autorisé.
Remove IP addresses after (days)	Par défaut 90, de 1 à 3650 autorisé.
Recorded sources	Activable par source, toutes actives par défaut. Toujours enregistrés, quoi qu'il arrive : les connexions, les modifications des utilisateurs EasyUC, de leurs rôles et des utilisateurs d'API, ainsi que l'export et les réglages du journal d'audit.
CUCM sources per connection	Indique pour chaque connexion CUCM si le change feed et le journal d'audit CUCM sont activés. Edit mène au réglage sur la connexion.
Classic view	Ouvre l'ancienne liste de journal. À partir de là, ou via Show original entry dans les détails, Restore fonctionne encore pour les entrées de l'ancien journal.

Comment lire la liste et les détails

Comment lire la liste et les détails
Champ / action	Signification et utilisation
Time	Relatif (« 5 minutes ago »), avec l'heure exacte au survol. Une icône d'horloge signale les heures inexactes : pour les modifications CUCM, précises à l'intervalle d'interrogation près ; pour les entrées importées, reprises de l'ancien journal.
Source	Admin UI, Self-service, Public API, Background job, Asynchronous (queue), CUCM direct, CUCM audit log ou Legacy log.
Performed by	Utilisateur EasyUC, utilisateur d'API, utilisateur final, système, administrateur CUCM ou Unknown. Unknown s'affiche pour les modifications CUCM directes tant que le journal d'audit CUCM n'a pas fourni l'utilisateur.
Action	Libellé de l'action avec un badge coloré pour le type : Create, Update, Delete, Sign in, Sign out, Execute ou Other.
Object	Objet principal de l'action, par exemple téléphone, utilisateur, ligne ou groupe.
Affected	Clés de recherche telles que nom de terminal, adresse MAC, numéro de téléphone ou ID d'utilisateur. Un clic filtre dessus.
Location	Site de l'objet, sinon No location.
Result	Successful, Failed, Partially successful ou Unknown.
Badge "Not completed"	L'action a été démarrée mais jamais terminée, par exemple parce qu'un service a été redémarré entre-temps.
Badge "Possible echo"	Probablement l'écho d'une modification EasyUC que le CUCM a renvoyée.
Changes tab	Field, Before, After. Pour les secrets, seul « Changed (value is not stored) » est affiché.
Involved tab	Modifications individuelles (par exemple chaque appel AXL avec résultat et texte d'erreur) et objets concernés.
Technical tab	Adresse IP, ID de requête, état HTTP, paramètres de route et données techniques brutes sous forme masquée. Visible uniquement avec un rôle distinct.
Open linked entry	Pour les entrées CUCM, mène à l'action EasyUC associée, et inversement.

Contrôler le résultat et circonscrire les erreurs

Testez la fonction avec une petite modification de votre choix, comme la description d'un téléphone de test. Elle apparaît immédiatement avec la source Admin UI, votre utilisateur et le champ sous Changes.
Vous ne voyez aucune entrée : vérifiez la période (7 jours par défaut), la connexion CUCM dans l'en-tête et votre restriction de site.
« You do not have permission to view the change log. » : ROLE_APP_LIST_LOG manque. Les autorisations du widget de journaux ou de l'historique du profil utilisateur final ne suffisent pas.
« You are not allowed to view technical details. » : ROLE_APP_VIEW_AUDIT_TECHNICAL manque.
« The filter is invalid (…). Please check your input. » : corrigez le champ de filtre nommé, par exemple une période supérieure à 366 jours.
« Too many matches for the export: at most … rows. » : restreignez le filtre ou n'exportez que les entrées les plus récentes.
Une modification apparaît deux fois : une fois comme action EasyUC et une fois comme écho possible du CUCM. Les échos ne sont visibles que si l'option correspondante est activée.
Aucun utilisateur n'est affiché pour « CUCM direct » : le change feed du CUCM ne connaît pas l'utilisateur. Le journal d'audit CUCM l'ajoute s'il est activé sur la connexion.
Une tâche d'arrière-plan quotidienne supprime les entrées plus anciennes selon les durées de conservation. Les grands environnements produisent plusieurs Go par an. Surveillez le volume de la base de données ; les durées de conservation sont le levier pour cela.
Si la source Admin UI est désactivée, toutes les autres actions de l'interface ne sont plus enregistrées. Ne désactivez des sources que délibérément.