Configurer le journal des modifications CUCM sur la connexion

À quoi cela sert

Le journal d’audit d’EasyUC consigne qui a modifié quoi dans EasyUC. Les modifications qu’une personne effectue directement dans l’administration du CUCM sont d’abord inconnues d’EasyUC. Dans la boîte de dialogue CUCM change log, vous définissez pour chaque connexion CUCM si et comment EasyUC saisit de telles modifications.

Il existe deux niveaux. Le Change feed interroge régulièrement le CUCM pour obtenir les objets modifiés. Il indique ce qui a changé et quand, mais pas par qui. Les entrées apparaissent dans le journal d’audit avec la source « CUCM direct ». Le second niveau exploite en plus le journal d’audit du CUCM et ajoute l’utilisateur et l’adresse IP ; ses entrées portent la source « CUCM audit log ».

EasyUC ne modifie rien sur le CUCM pour cela. Le flux de modifications est aussi la base qui permet à la sauvegarde CUCM de saisir les modifications en quelques minutes.

Prérequis

Connexion en tant qu’administrateur (ROLE_APP_ADMIN). Les paramètres de la connexion ne sont attribués à aucun autre rôle.
Licence avec le module cucm. L’entrée ne dépend pas de la licence de provisioning. La connexion est activée.
Dans les paramètres du journal d’audit (« Retention and sources »), les sources « CUCM direct » et, pour le second niveau, « CUCM audit log » sont activées.
Pour le second niveau, sur le CUCM : sous Cisco Unified Serviceability → Tools → Audit Log Configuration, « Enable Audit Log » et « Detailed Audit Logging » sont activés et enregistrés avec « Apply to All Nodes ».
Pour le second niveau : les services réseau « Cisco Audit Event Service » et « Cisco Log Partitions Monitoring Tool » sont en cours d’exécution sur tous les nœuds.
Pour le second niveau : l’utilisateur AXL de la connexion peut lire les journaux de serviceability, par exemple via le rôle « Standard CCM Server Monitoring ». Tous les nœuds CUCM actifs sont joignables depuis l’appliance par leur nom.

Procédure pas à pas

Sélectionnez l’espace de travail EasyUC Cisco dans l’en-tête.
Ouvrez Administration → CUCM & Provisioning → CUCM Connections.
Dans la ligne de la connexion, cliquez sur Actions puis sur CUCM change log. La boîte de dialogue s’ouvre avec l’alias de la connexion. Si rien n’a encore été enregistré, elle affiche les valeurs par défaut.
Laissez Fetch CUCM changes (change feed) activé, ou activez l’option.
Sous Monitored object types, sélectionnez les types souhaités ou All.
Saisissez le Polling interval (seconds).
Si l’utilisateur CUCM qui a effectué la modification doit aussi apparaître et que les prérequis sur le CUCM sont remplis : activez Evaluate the CUCM audit log (who made the change).
Si EasyUC utilise d’autres utilisateurs CUCM en plus de l’utilisateur AXL de la connexion, saisissez-les sous Additional EasyUC AXL users : tapez le nom et appuyez sur Entrée.
Cliquez sur Save. Le message CUCM change log saved s’affiche.
Pour vérifier, modifiez un téléphone directement dans le CUCM et, une fois l’intervalle d’interrogation écoulé, consultez la page Audit log.

Champs et options

Champs et options
Champ / action	Signification et utilisation
Fetch CUCM changes (change feed)	Par défaut : activé. « Regularly asks the CUCM for changed objects. Shows what changed and when, but not by whom. » Lorsqu’il est désactivé, les modifications directes sur le CUCM n’apparaissent pas dans le journal d’audit. Après sa réactivation, la collecte repart à zéro, sans la période intermédiaire.
Monitored object types	Phone, DeviceProfile, Line, User, RemoteDestination, RemoteDestinationProfile, HuntPilot, HuntList, LineGroup, CallPickupGroup, TransPattern, RoutePattern et Application User. Par défaut : tous. Au moins un type doit être sélectionné.
Polling interval (seconds)	Valeurs autorisées : 60 à 300 secondes. Par défaut : 60.
Evaluate the CUCM audit log (who made the change)	Par défaut : désactivé. « Adds user and IP address from the CUCM audit log. » En dessous, la boîte de dialogue énumère les cinq étapes à réaliser au préalable sur le CUCM et la remarque « The CUCM audit log format has not yet been confirmed with real files. »
Additional EasyUC AXL users	Les modifications de ces utilisateurs comptent comme des modifications EasyUC et ne sont pas listées comme des modifications directes du CUCM. L’utilisateur AXL de la connexion est toujours inclus. 20 entrées au maximum, de 128 caractères au maximum chacune.
Save / Cancel	Enregistre le paramètre pour cette connexion, ou ferme la boîte de dialogue sans aucune modification.

Vérifier le résultat et circonscrire les erreurs

Succès : les modifications directes sur le CUCM apparaissent sur la page Audit log avec la source « CUCM direct », complétée par l’utilisateur CUCM lorsque le second niveau est activé.
Les entrées issues du journal d’audit du CUCM apparaissent avec un délai. La documentation interne indique environ 5 à 20 minutes après la modification, et un délai plus long en cas d’intervalle d’interrogation plus long.
« Please select at least one object type. » : aucun type d’objet n’est coché.
« The CUCM change log settings could not be saved. » : vérifiez les saisies et enregistrez à nouveau ; l’intervalle d’interrogation doit être compris entre 60 et 300.
Aucune entrée n’apparaît : vérifiez dans les paramètres du journal d’audit si la source « CUCM direct » est saisie, et sous Background Jobs si le job du flux de modifications est activé.
L’utilisateur manque malgré le second niveau : sur le CUCM, vérifiez « Detailed Audit Logging », les deux services réseau et les autorisations de serviceability de l’utilisateur AXL.
Les connexions au CUCM et les déconnexions ne sont pas enregistrées par défaut. Les mots de passe et les codes PIN n’apparaissent que comme « changed », sans valeur.
L’association entre l’utilisateur et la modification repose sur le temps. Si deux administrateurs modifient le même objet à quelques minutes d’intervalle, l’utilisateur peut apparaître sur la mauvaise entrée.