Détails d'un nœud CUCM via SSH et identifiants SSH

À quoi cela sert

Avec Details (SSH), EasyUC lit l'état d'un nœud CUCM directement depuis son CLI de plateforme : version active et inactive, matériel, configuration IP et DNS, ainsi que l'état des services de fonctionnalités et des services réseau. Cela aide lorsqu'un nœud se comporte de façon étrange et que vous voulez savoir si un service est arrêté ou quelle version est réellement active.

EasyUC se connecte pour cela au nœud via SSH. Depuis la version 4.8.3, les identifiants SSH doivent être enregistrés séparément. Un administrateur plateforme/OS du CUCM est requis, et non l'utilisateur AXL. Le mot de passe est enregistré chiffré et n'est plus jamais affiché.

Lors du premier contact, EasyUC enregistre la clé d'hôte SSH du nœud. Si la clé change par la suite, EasyUC ne se connecte plus et n'envoie aucun mot de passe tant qu'une personne autorisée n'a pas vérifié et confirmé la nouvelle clé.

Prérequis

Module de licence cucm.
Pour consulter : autorisation View CUCM node details (SSH) (ROLE_APP_CUCM_NODE_DETAILS).
Pour enregistrer, modifier, supprimer et tester les identifiants, et pour confirmer une nouvelle clé d'hôte : autorisation Change SSH credentials (ROLE_APP_CUCM_NODE_DETAILS_EDIT).
Les administrateurs (ROLE_APP_ADMIN, ROLE_OWNER, ROLE_ADMIN, ROLE_SUPER_ADMIN) disposent des deux autorisations. Les rôles de helpdesk ne les reçoivent que si elles sont attribuées explicitement dans l'éditeur de rôles.
Les utilisateurs sans rôle d'administrateur ne voient les détails que pour les connexions CUCM qui leur sont attribuées.
Un compte d'administrateur plateforme/OS du CUCM. Pour les nœuds IM&P disposant de leur propre administrateur OS, des identifiants différents peuvent être enregistrés par nœud.
EasyUC joint le nœud via SSH (port 22 par défaut). Le nom du nœud issu du CUCM doit pouvoir être résolu depuis EasyUC ; sinon, saisissez une adresse.

Pas à pas : enregistrer les identifiants SSH

Sélectionnez la connexion CUCM dans l'en-tête et ouvrez le Dashboard.
Sur la carte du nœud CUCM, cliquez sur Details (SSH).
Si aucun identifiant n'est encore enregistré, cliquez sur Enter SSH credentials. Sinon, ouvrez la boîte de dialogue avec SSH credentials.
Saisissez User name et Password de l'administrateur OS.
Sous Applies to, choisissez soit all nodes of this CUCM connection, soit this node only.
Cliquez sur Test connection. En cas de succès, « Connection successful. », la version active et la clé d'hôte SSH apparaissent.
Cliquez sur Save.
La page de détail charge les informations du nœud. Refresh les relit.

Pas à pas : confirmer une clé d'hôte modifiée ou saisir une adresse

Si la page de détail signale une clé modifiée, cliquez sur Review new key.
Comparez l'empreinte sous Now reported avec l'empreinte que vous avez déterminée sur le nœud lui-même.
Cochez I have verified the new fingerprint through a trusted channel. et cliquez sur Accept new key.
Testez ensuite à nouveau la connexion.
Si EasyUC ne peut pas résoudre le nom du nœud, cliquez sur Address…, saisissez l'adresse sous IP address or host name et enregistrez.

Champs et options

Champs et options
Champ / action	Signification et utilisation
User name / Password	Administrateur plateforme/OS du CUCM. Lors d'une modification : laissez le mot de passe vide pour conserver celui qui est enregistré.
Applies to	all nodes of this CUCM connection ou this node only. Les identifiants d'un seul nœud sont prioritaires.
Test connection	Établit une connexion SSH et affiche la version active et la clé d'hôte.
Remove credentials	Supprime les identifiants enregistrés. Un nœud isolé utilise alors les identifiants de la connexion, s'ils sont enregistrés.
Address…	Adresse IP manuelle (IPv4 ou IPv6) ou nom d'hôte résoluble du nœud, sans port et sans `https://`. S'applique à « Details (SSH) » et à l'interrogation de la tuile CUCM Information. Reset utilise de nouveau le nom issu du CUCM.
Accept new key	Remplace la clé d'hôte SSH enregistrée du nœud par celle qui est maintenant signalée.

Comment lire la page de détail

Comment lire la page de détail
Champ / action	Signification et utilisation
Active Version / Inactive Version	Version logicielle en cours d'exécution du nœud et version de la partition inactive.
Hardware	Informations de plateforme sur le matériel (virtuel).
IP Configuration & DNS	Paramètres réseau du nœud.
Feature & Network Services	Par service, l'état tel que rapporté par la plateforme. « No services returned » signifie que l'interrogation n'a livré aucune liste.
SSH host	Adresse par laquelle EasyUC joint le nœud, avec la mention « (entered manually) » pour une adresse enregistrée.
SSH host key	Empreinte du nœud avec son origine : « stored on first contact on … » ou « confirmed on … by … ».
Credentials: …	Indique si les identifiants s'appliquent à tous les nœuds de la connexion ou à ce nœud uniquement.

Contrôler le résultat et circonscrire les erreurs

Vous reconnaissez le succès lorsque la page de détail affiche la version, le matériel, le réseau et les services.
« No SSH credentials are stored for this node. » ou, sans l'autorisation de modification, « Credentials missing – please ask an administrator … » : enregistrez les identifiants comme décrit ci-dessus.
« Login to the node was rejected – check the OS administrator's user name and password. » : l'utilisateur AXL a probablement été saisi au lieu de l'administrateur OS, ou le mot de passe est erroné.
« The node's SSH key has changed. For security reasons, no login was attempted. » : normal après une réinstallation ou une restauration du nœud. Vérifiez l'empreinte et acceptez la nouvelle clé.
« The stored SSH credentials can no longer be read … and must be entered again. » : survient après une restauration vers une autre instance. Saisissez à nouveau les identifiants.
« The address of this node is new or has changed. For security reasons, EasyUC only sends the stored SSH password there once it has been entered again or successfully tested with the password for this address. » : saisissez à nouveau le mot de passe dans la boîte de dialogue et testez.
« The node cannot be reached via SSH. » : contrôlez le pare-feu et le port SSH entre EasyUC et le nœud.
« No secure SSH connection possible (key exchange failed). » : EasyUC prend en charge les clés d'hôte RSA, comme celles utilisées par le CUCM. Une cible qui ne propose que ECDSA ou Ed25519 est rejetée.
« The node name is a short name without a domain. Enter the IP address or the FQDN as the server name in the CUCM. » : saisissez l'adresse via Address… ou corrigez le nom du serveur dans le CUCM.
Chaque utilisation de « Details (SSH) » et chaque modification des identifiants ou de la clé d'hôte est consignée dans le journal d'audit, sans le mot de passe.