Connectez Forescout eyeControl, via son API Web sur votre appliance Enterprise Manager, pour importer les hôtes détectés dans Dispel en tant qu’appareils — associés à un Wicket et actualisés lors d’une synchronisation récurrente.
L’intégration Forescout permet à Dispel de récupérer les hôtes détectés par Forescout sur votre réseau et de les ajouter en tant qu’appareils Dispel. Vous vous connectez une seule fois à votre appliance Forescout, vous l’associez à un établissement et à un Wicket Dispel, puis Dispel importe les appareils correspondants et les met à jour lors de synchronisations récurrentes.
Forescout est une intégration de découverte des ressources sur site. Plus précisément, Dispel s’intègre à Forescout eyeControl via son API Web (le module eyeExtend Connect ), et ne fait que lire les données. Vous indiquez à Dispel l’adresse de votre Enterprise Manager — l’appliance de gestion centrale de Forescout, qui regroupe les appliances Forescout individuelles de votre réseau. Vous déployez et exploitez vous-même l’Enterprise Manager (sous forme d’appliance physique ou virtuelle) : il ne s’agit donc pas d’un service cloud hébergé par Forescout. Dispel y accède à une adresse située dans votre propre environnement ; c’est pourquoi la connexion utilise souvent une URL privée et l’option de certificat autosigné.
Comme l’Enterprise Manager représente un environnement unique, Dispel le traite comme un site à associer à un seul Wicket : il n’y a pas de liste de sites à parcourir.
Les hôtes détectés (nom, adresse IP, adresse MAC, fabricant/modèle, système d’exploitation, type d’appareil), ajoutés en tant qu’appareils Dispel.
Les protocoles et ports réseau observés pour chaque hôte.
Un lien vers l’hôte dans Forescout, enregistré sur l’appareil.
Vous aurez besoin des éléments suivants, disponibles dans votre console Forescout :
Un utilisateur de l’API Web — créez-en un dans Tools → Options → Web API → User Settings. Dispel s’authentifie avec le nom d’utilisateur et le mot de passe.
de cet utilisateur. L’URL de l’Enterprise Manager de votre appliance — par exemple https://192.168.1.100.
Si votre appliance utilise un certificat TLS autosigné, vous devrez activer l’option correspondante lors de la configuration.
Accédez à Paramètres → Intégrations et cliquez sur Connecter sur la carte Forescout.
Vous pouvez éventuellement définir un Nom d’affichage pour distinguer cette intégration des autres (vous pouvez connecter plusieurs appliances).
Renseignez les champs de connexion :
Cliquez sur Tester la connexion pour vérifier que Dispel peut s’authentifier auprès de l’appliance. Corrigez toute erreur signalée avant d’enregistrer.
Cliquez sur Enregistrer. Dispel enregistre l’intégration et lance immédiatement la synchronisation initiale.
Une fois la synchronisation initiale terminée, ouvrez l’intégration pour trouver la section Association des sites . Forescout apparaît comme un site unique représentant votre appliance.
Associez chaque site du fournisseur à un établissement et à un wicket Dispel. Les appareils des sites associés seront synchronisés avec Dispel.
Sélectionnez un Établissement.
Sélectionnez un Wicket. Si l’établissement ne possède qu’un seul wicket, Dispel le sélectionne automatiquement.
Cliquez sur Enregistrer les associations et importer.
Dispel importe les hôtes de l’appliance dans le wicket associé — vous verrez la progression passer de « en attente » à « récupération », puis à « synchronisation » et enfin à « terminé » — et indique ensuite le nombre d’appareils importés (par exemple, "12 devices imported" ou une répartition entre les nouveaux appareils et ceux déjà importés). Les appareils importés apparaissent dans le wicket associé, avec ceux que vous avez ajoutés manuellement.
Dispel effectue automatiquement une nouvelle synchronisation selon une fréquence régulière, afin que les nouveaux hôtes détectés et les détails modifiés soient pris en compte sans que vous ayez à intervenir.
Pour récupérer immédiatement le dernier inventaire, ouvrez l’intégration et sélectionnez Actualiser.
Pour modifier les détails de connexion ou renouveler les identifiants, modifiez l’intégration et sélectionnez Enregistrer et synchroniser. Laissez les champs des identifiants vides pour conserver le mot de passe actuel.
Chaque intégration affiche un état pour que vous sachiez toujours où elle en est :
Un indicateur d’état distinct de la connexion (Connectée, Dégradée, Injoignable) indique si Dispel peut actuellement joindre l’appliance Forescout.
Si une synchronisation ou un test de connexion échoue, Dispel classe l’erreur et suggère une solution :
URL d’Enterprise Manager
Configuration
L’URL de votre appliance Forescout Enterprise Manager.
Autoriser les certificats auto-signés
Configuration
Activez cette option si votre appliance utilise un certificat TLS auto-signé.
Nom d’utilisateur
Identifiant
L’utilisateur de l’API Web créé dans la console Forescout.
Non initialisée
Enregistrée, mais la première synchronisation n’a pas encore été lancée.
Initialisation
Première synchronisation en cours.
Prête
Connectée et synchronisée ; le mappage est appliqué.
Actualisation nécessaire
De nouvelles données du fournisseur sont disponibles ; lancez une actualisation pour les récupérer.
Actualisation en cours
Échec de l’authentification
Le nom d’utilisateur ou le mot de passe de l’API Web a été refusé. Vérifiez que l’utilisateur de l’API Web existe et que le mot de passe est à jour.
Point de terminaison inaccessible
Dispel n’a pas pu joindre l’appliance. Vérifiez l’URL d’Enterprise Manager et que l’adresse IP de Dispel figure sur la liste d’autorisation de votre pare-feu.
Erreur de certificat
L’appliance a présenté un certificat TLS non fiable. Si elle utilise un certificat auto-signé, activez Autoriser les certificats auto-signés dans les paramètres de connexion.
Délai de connexion dépassé
L’appliance a mis trop de temps à répondre — cela est souvent dû à la latence du réseau ou à une règle de pare-feu entre Dispel et votre réseau.
Erreur de configuration
Mot de passe
Identifiant
Le mot de passe de l’utilisateur de l’API Web. Il est stocké sous forme chiffrée et ne sera plus jamais affiché.
Une synchronisation est en cours.
Modifications en attente
Les modifications du mappage sont enregistrées, mais pas encore appliquées.
Application en cours
Importation des appareils selon le mappage enregistré.
Échec
La dernière opération a échoué — consultez les conseils de résolution des erreurs.
L’URL semble incorrecte ou l’API Web n’est pas activée sur l’appliance. Vérifiez à nouveau les paramètres de connexion.