Connecteur Ivanti Neurons

Le Connecteur Ivanti Neurons alimente la CMDB de Portail ZAPP avec le parc géré par Ivanti Neurons, la plateforme cloud d'Ivanti. Portail ZAPP interroge directement l'API de Neurons : aucun agent n'est à installer. Les écrans sont réservés aux administrateurs ; l'entrée Ivanti Neurons se trouve dans le menu Administration › Connecteurs et automatisation.

Ce connecteur ne remplace pas le Connecteur Ivanti UEM, qui lit l'ancienne console installée chez vous (Ivanti EPM) par un agent Outpost.

Ce qui est importé

À chaque collecte, le connecteur lit les appareils de Neurons et crée ou met à jour, dans la CMDB :

• un Ordinateur par appareil : nom, domaine, numéro de série, Marque et Modèle, système d'exploitation, processeur, mémoire, Utilisateur principal ;
• un Disque par disque local (C:, D:…), avec sa capacité et son espace libre ;
• une Interface réseau par carte, avec son adresse MAC et son adresse IP ;
• les logiciels installés (liste Ajout/Suppression de programmes), si l'option est cochée.

Appareils sans agent : Neurons connaît aussi des appareils seulement découverts sur le réseau, sans agent installé. Ils ne portent guère que leur adresse MAC, leur adresse IP et le nom de leur système. Ils ne sont importés que si l'option Appareils découverts sans agent est cochée. Parmi eux, les équipements d'infrastructure (switchs, routeurs, imprimantes…) sont importés comme Équipements réseau, avec leurs adresses, leur marque et leur modèle, et non comme ordinateurs.

Un poste déjà connu n'est pas dupliqué : s'il a été importé par une autre source (Intune, GLPI, Ivanti UEM…), il est rapproché par son UUID BIOS, son numéro de série, ses adresses MAC ou son nom, et ses champs sont complétés. Les numéros de série génériques des constructeurs (« Default string », « To Be Filled By O.E.M. »…) ne servent jamais au rapprochement.

Utilisateur principal : Portail ZAPP cherche le compte de l'utilisateur que Neurons associe au poste, d'abord par son adresse e-mail Entra ID, puis par son login de domaine (DOMAINE\compte), sans tenir compte des majuscules ni des accents. Un compte local du poste (NOM-DU-POSTE\compte) n'est jamais utilisé. Si aucun compte ne correspond, ou si plusieurs comptes correspondent, le champ n'est pas modifié ; le poste est importé quand même. Vous pouvez rattacher vous-même ces utilisateurs, comptes locaux compris : voir Réconcilier les utilisateurs.

Les postes importés se consultent dans la CMDB, type Ordinateur.

Avant de créer une source

Côté Neurons, un administrateur enregistre une application autorisée à lire les données (Data Services). Neurons lui donne :

• l'URL d'autorité, de la forme https://xxx-sfc.ivanticloud.com/xxx.ivanticloud.com/connect/token ;
• l'ID client ;
• le secret client.

Dans Portail ZAPP, enregistrez la valeur du secret client dans le Coffre de secrets : la source désigne ce secret par son nom, jamais par sa valeur.

Créer une source

La page Sources Ivanti Neurons liste les sources avec leur nom, leur slug, l'hôte de l'API appelé, 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) ;
• URL d'autorité : telle que Neurons l'a donnée, en https://. Portail ZAPP en déduit l'hôte de l'API et le tenant, affichés ensuite sur la fiche de la source ;
• ID client ;
• Secret : choisissez le secret dans la liste. Si la liste est vide, le lien en créer un mène au coffre de secrets ;
• Hôte de l'API et Tenant : à laisser vides, sauf indication d'Ivanti ;
• Délai par appel : en secondes, de 5 à 300 (60 par défaut) ;
• Logiciels installés et Appareils découverts sans agent : voir plus haut ;
• Relier les contacts CMDB aux postes : voir Réconcilier les utilisateurs ;
• Planification (cron, optionnel) : la fréquence de collecte, choisie avec l'assistant. Sans planification, la source n'est collectée que par Synchroniser maintenant.

Cliquez sur Enregistrer. Une saisie invalide est signalée et rien n'est enregistré.

Tester, synchroniser

Sur la fiche de la source :

• Tester la connexion demande un jeton à Neurons et lit un appareil ; en cas de succès, le nombre d'appareils annoncé par Neurons s'affiche. Rien n'est importé.
• Synchroniser maintenant lance une collecte en arrière-plan ; rechargez la page pour voir son résultat dans le cadre Dernière collecte (statut, appareils importés, erreurs). Le bouton existe aussi dans la liste des sources.

Réconcilier les utilisateurs

Le bouton Réconcilier les utilisateurs de la fiche indique le nombre d'utilisateurs à traiter : ceux que Portail ZAPP n'a rattachés à aucun compte. La page Utilisateurs Neurons les liste (onglet À traiter, ou Tous). Neurons ne donne pas le nom des utilisateurs : chacun est désigné par son adresse e-mail Entra ID, sinon par son compte DOMAINE\compte. Un badge compte local signale un compte du poste lui-même. Pour chacun, la page montre le nombre de postes concernés, le résultat du rapprochement automatique et la décision prise.

• Lier (par ligne) : choisissez un compte Portail ZAPP dans la liste (recherche sans tenir compte des majuscules ni des accents). C'est le seul moyen de rattacher un compte local.
• Créer les contacts (utilisateurs cochés) : crée dans la CMDB un contact par utilisateur, nommé par son adresse (sinon par son compte) et rattaché au tiers choisi, puis le lie à l'utilisateur.
• Ignorer (utilisateurs cochés) : l'utilisateur n'est plus jamais rattaché et sort de la liste à traiter.
• Retirer la décision (utilisateurs cochés) : l'utilisateur repasse par le rapprochement automatique.

Une décision prime sur le rapprochement automatique et s'applique à la collecte suivante ; Synchroniser maintenant l'applique tout de suite. Un utilisateur lié à un contact ou ignoré ne renseigne plus l'utilisateur principal de ses postes. Si l'option Relier les contacts CMDB aux postes de la source est cochée, ses postes sont reliés au contact (« utilisé par »).

Activer, modifier, supprimer

• Le bouton de la colonne Activée (Oui / Non) active ou suspend la source et sa collecte planifiée. Une source suspendue ne se synchronise pas.
• Modifier ouvre la fiche ; vider la planification supprime la collecte planifiée.
• La corbeille supprime la source et sa collecte, après confirmation, ainsi que ses décisions sur les utilisateurs. Les postes déjà importés et les contacts créés restent dans la CMDB.

Codes d'erreur

Une collecte en échec, ou un test de connexion refusé, affiche un code :

Une collecte qui ne trouve aucun appareil est réussie, avec 0 appareil.