Connecteur Ivanti UEM

Le Connecteur Ivanti UEM alimente la CMDB de Portail ZAPP avec l'inventaire des machines gérées par un serveur Ivanti UEM. Ce serveur est en général installé dans votre réseau et injoignable depuis l'extérieur : la collecte passe donc par les agents Outpost installés chez vous, qui interrogent le serveur Ivanti et renvoient le résultat. Les écrans sont réservés aux administrateurs ; l'entrée Ivanti UEM se trouve dans le menu Administration › Connecteurs et automatisation.

Ivanti UEM désigne ici la console installée chez vous (Ivanti EPM, Endpoint Manager). Pour la plateforme en ligne d'Ivanti, voir la page « Connecteur Ivanti Neurons ».

Ce qui est importé

Pour chaque machine de la requête Ivanti choisie, le connecteur crée ou met à jour, dans la CMDB, un Ordinateur (nom, domaine, système d'exploitation, processeur, mémoire) avec ses Disques, ses Interfaces réseau et ses Logiciels installés. Les informations réellement renvoyées dépendent de la définition de colonnes préparée dans la console Ivanti (voir plus bas) : une colonne absente de cette définition n'est pas importée.

Une machine déjà connue n'est pas dupliquée : si une autre source (par exemple le connecteur Intune) l'a déjà importée, elle est rapprochée par son numéro de série, ses adresses MAC ou son nom, et ses champs sont complétés. Pour le numéro de série et le modèle, Ivanti UEM fait foi face à Intune, car il lit le matériel directement. Le connecteur Ivanti ne renseigne pas l'Utilisateur principal.

Les machines importées se consultent dans la CMDB, type Ordinateur.

Avant de créer une source

• Dans Portail ZAPP, un groupe de machines Outpost (menu Administration › Connecteurs et automatisation › Outpost › Groupes de machines) contient le ou les agents qui feront la collecte. Les agents doivent pouvoir joindre le serveur Ivanti.
• Dans la console Ivanti, l'administrateur Ivanti a créé une définition de colonnes (elle fixe les informations renvoyées : BIOS, processeur, mémoire, stockage, réseau, logiciels…) et, de préférence, une requête qui sélectionne les machines à inventorier.
• Un compte de service Ivanti autorisé à lire l'inventaire ; son mot de passe est enregistré dans le Coffre de secrets de Portail ZAPP. La source désigne ce secret par son nom, jamais par sa valeur.

Créer une source

La page Sources Ivanti UEM liste les sources avec leur nom, leur slug, leur planification et leur état. Cliquez sur + Nouvelle source et renseignez :

• Nom et Slug (identifiant court ; il ne se modifie plus après la création) ;
• Groupe de machines : la collecte est déclenchée sur chaque agent membre du groupe ;
• URL du Webservice MBSDK : l'adresse complète du service web Ivanti, chemin compris, par exemple https://ivanti.example.local/MBSDKService/MsgSDK.asmx — pas seulement le nom du serveur ;
• Compte de service Ivanti et Secret (mot de passe du compte) ;
• Nom de la définition de colonnes Ivanti, tel qu'il est écrit dans la console Ivanti ;
• Filtre de liste de machines Ivanti : le nom de la requête Ivanti à inventorier. Vous pouvez le saisir, ou cliquer sur Charger la liste pour obtenir les requêtes du serveur Ivanti (il faut avoir renseigné avant le groupe de machines, l'adresse, le compte et le secret). Si le chargement échoue (« L'agent n'a pas répondu à temps. », « Ce groupe de machines ne contient aucun agent. »…), le champ garde sa valeur et reste modifiable ; « Aucun agent actif dans ce groupe de machines : ses membres sont révoqués, en quarantaine ou archivés. » signale un groupe qui a des machines, mais aucune active : réactivez l'une d'elles ou ajoutez au groupe un agent actif ;
• Délai d'attente Ivanti (secondes) : 30 par défaut ;
• Planification (cron, optionnel) : la fréquence de collecte, choisie avec l'assistant. Sans planification, la source n'est jamais déclenchée automatiquement.

Cliquez sur Enregistrer.

Activer, modifier, supprimer

• Le bouton de la colonne Activée active ou suspend la source et sa collecte planifiée.
• Modifier ouvre le même formulaire ; vider la planification supprime la collecte planifiée.
• La corbeille supprime la source et sa collecte planifiée, après confirmation. Les machines déjà importées restent dans la CMDB.

Déroulement d'une collecte

1. À l'heure prévue, Portail ZAPP envoie la demande de collecte à chaque agent du groupe, l'un après l'autre. Chaque agent fait sa propre collecte, sans regroupement entre agents. Un groupe vide ne produit aucune collecte et n'est pas une erreur.
2. Les agents travaillent en arrière-plan. Toutes les 2 minutes, la tâche IvantiInventoryPollCollection relève les collectes terminées et intègre leurs machines dans la CMDB. Une machine illisible n'empêche pas l'intégration des autres.

Suivre les collectes

La page Modifier d'une source montre son Activité de la source :

• Dernier déclenchement planifié : début, statut et, en cas d'échec, l'explication ;
• Dernières collectes : une ligne par agent et par collecte (début, statut, machines importées, erreurs), avec le code de l'échec et son explication dans votre langue.

Chaque source planifiée crée aussi une tâche dans le Planificateur (Administration › Instance et exploitation › Planificateur), nommée Connector.IvantiUEM: suivi de l'identifiant de la source. Sa fiche permet de Déclencher maintenant une collecte et affiche l'Historique d'exécution :

• Success : les demandes de collecte sont parties vers les agents du groupe. Le résultat des collectes elles-mêmes apparaît dans l'activité de la source et dans la CMDB, après le passage de la tâche IvantiInventoryPollCollection. Attention : si le groupe ne contient plus aucun agent (ou a été supprimé), la tâche réussit aussi, sans rien collecter — vérifiez le groupe si aucune machine n'arrive ;
• Error : la collecte n'a pas pu partir ; l'historique en donne l'explication (voir « Dépannage »).

La tâche IvantiInventoryPollCollection passe en PartialSuccess quand une collecte relevée a échoué : son historique en donne la cause. Si plusieurs collectes ont échoué, il en donne le nombre et le détail par source : ouvrez l'activité de chaque source.

Dépannage

Chaque échec porte un code stable (repris par l'API et les exports, suivi d'une phrase en anglais) et une explication dans la langue de l'utilisateur. Le détail technique (message de l'agent, réponse du serveur Ivanti) n'est jamais affiché : il est écrit dans le journal du serveur et dans celui de l'agent.

Un agent Outpost à jour transmet lui-même le code de la cause et le statut HTTP : l'explication ne dépend plus du texte de son message. Avec un agent plus ancien, la cause est déduite de ce texte, comme avant.

Un code absent de ce tableau s'affiche sous la forme « Échec de la collecte : code » ; une erreur imprévue s'affiche « Erreur inattendue » avec son type, le détail étant dans le journal du serveur.