> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-fr/integrer-et-administrer/integrations/asset-discovery/forescout.md).
# Forescout
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.
## Vue d’ensemble
L’intégration Forescout permet à Dispel de récupérer les hôtes que Forescout a découverts sur votre réseau et de les intégrer comme appareils Dispel. Vous vous connectez une seule fois à votre appliance Forescout, vous la mappez à une installation Dispel et à un Wicket, puis Dispel importe les appareils correspondants et les tient à jour lors d’une synchronisation récurrente.
Forescout est une solution sur site **de découverte d’actifs** intégration. Plus précisément, Dispel s’intègre avec **eyeControl** via son API Web (le **module eyeExtend Connect** module), et ne fait que le lire. Vous pointez Dispel vers votre **Enterprise Manager** — l’appliance centrale de gestion de Forescout, qui agrège les appliances Forescout individuelles de votre réseau. Vous déployez et exécutez vous-même Enterprise Manager (en tant qu’appliance physique ou virtuelle), donc ce n’est pas un service cloud hébergé par Forescout — Dispel y accède à une adresse située dans votre propre environnement, ce qui explique pourquoi la connexion utilise souvent une URL privée et l’option de certificat auto-signé.
Comme Enterprise Manager représente un environnement unique, Dispel le considère comme un seul **site** que vous associez à un seul Wicket — il n’y a pas de liste par site à parcourir.
{% hint style="info" %}
**Note sur les noms Forescout.** « eyeControl » est le produit Forescout auquel Dispel se connecte ; « Enterprise Manager » est l’appliance de gestion vers laquelle vous pointez Dispel. Le champ de connexion est libellé **URL de l’Enterprise Manager** pour correspondre au libellé utilisé dans la console Forescout.
{% endhint %}
#### Ce que Dispel importe
* Les hôtes découverts (nom, adresse IP, adresse MAC, marque/modèle, système d’exploitation, type d’appareil) comme appareils Dispel.
* Les protocoles et ports réseau observés pour chaque hôte.
* Un lien vers l’hôte dans Forescout, stocké sur l’appareil.
{% hint style="info" %}
**Où le trouver.** Connectez-vous en tant qu’administrateur de l’organisation et ouvrez **Paramètres → Intégrations**. Forescout apparaît dans la **section Découverte d’actifs / Visibilité réseau** section. Cliquez sur **Connecter** sur la carte Forescout pour commencer.
{% endhint %}
## Avant de commencer
Vous aurez besoin des éléments suivants depuis votre console Forescout :
* Un **utilisateur API Web** — créez-en un sous **Outils → Options → API Web → Paramètres utilisateur**. Dispel s’authentifie avec le **nom d’utilisateur** et **mot de passe**.
* Le **URL de l’Enterprise Manager** de votre appliance — par exemple `https://192.168.1.100`.
* Si votre appliance utilise un **certificat TLS auto-signé**, soyez prêt à activer l’option auto-signée pendant la configuration.
{% hint style="warning" %}
**Ajoutez l’IP de Dispel à la liste d’autorisation.** Lorsque vous ouvrez le formulaire de connexion, Dispel affiche une **IP de la liste d’autorisation** valeur. Ajoutez cette adresse à la liste d’autorisation de votre pare-feu réseau afin que Dispel puisse joindre l’appliance sur site.
{% endhint %}
## Connexion à Forescout
1. Accédez à **Paramètres → Intégrations** et cliquez sur **Connecter** sur la carte Forescout.
2. Vous pouvez éventuellement définir un **nom d’affichage** pour distinguer cette intégration des autres (vous pouvez connecter plusieurs appliances).
3. Renseignez les champs de connexion :
| Champ | Type | Notes |
| ----------------------------------------- | ------------- | ----------------------------------------------------------------------------- |
| **URL de l’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 API Web créé dans la console Forescout. |
| **mot de passe** | Identifiant | Le mot de passe de l’utilisateur API Web. Stocké chiffré et jamais réaffiché. |
4. Cliquez sur **Tester la connexion** pour confirmer que Dispel peut s’authentifier auprès de l’appliance. Corrigez toute erreur signalée avant d’enregistrer.
5. Cliquez sur **Enregistrer**. Dispel enregistre l’intégration et lance immédiatement la synchronisation initiale.
{% hint style="info" %}
**Vos identifiants sont chiffrés.** Le mot de passe est chiffré au repos et n’est plus jamais affiché après l’enregistrement. Lors d’une modification ultérieure, laissez les champs d’identifiants vides pour conserver les valeurs stockées.
{% endhint %}
## Association de l’appliance à un Wicket
Une fois la synchronisation initiale terminée, ouvrez l’intégration pour trouver la **section Mappage des sites** section. Forescout apparaît comme un seul site représentant votre appliance.
> Associez chaque site du fournisseur à une installation Dispel et à un Wicket. Les appareils des sites mappés seront synchronisés dans Dispel.
1. Choisissez un **site**.
2. Choisissez un **Wicket**. Si le site ne comporte qu’un seul Wicket, Dispel le sélectionne pour vous.
3. Cliquez sur **Enregistrer les mappages et importer**.
Dispel importe les hôtes de l’appliance dans le Wicket mappé — vous verrez la progression passer de l’attente à la récupération, puis à la synchronisation, jusqu’à l’achèvement — puis il indique combien d’appareils ont été importés (par exemple, **« 12 appareils importés »** ou une répartition entre les appareils nouveaux et déjà importés). Les appareils importés apparaissent dans le Wicket mappé aux côtés de tous les appareils que vous avez ajoutés manuellement.
## Maintenir votre inventaire à jour
* Dispel **se resynchronise automatiquement** selon un calendrier récurrent, de sorte que les hôtes nouvellement découverts et les détails modifiés soient pris en compte sans aucune action de votre part.
* Pour récupérer immédiatement le dernier inventaire, ouvrez l’intégration et choisissez **Actualiser**.
* Pour modifier les détails de connexion ou renouveler les identifiants, modifiez l’intégration et utilisez **Enregistrer et synchroniser**. Laissez les champs d’identifiants vides pour conserver le mot de passe actuel.
## État de la connexion
Chaque intégration affiche un état afin que vous sachiez toujours où elle en est :
| État | Signification |
| ---------------------------- | --------------------------------------------------------------------------------------------------- |
| **Non initialisé** | Enregistré, mais la première synchronisation n’a pas encore été exécutée. |
| **Initialisation** | Exécution de la première synchronisation. |
| **Prêt** | Connecté et synchronisé ; le mappage est appliqué. |
| **Doit être actualisé** | De nouvelles données du fournisseur sont disponibles ; lancez une actualisation pour les récupérer. |
| **Actualisation en cours** | Une synchronisation est en cours. |
| **Modifications en attente** | Les modifications de mappage sont enregistrées mais pas encore appliquées. |
| **Application en cours** | Importation des appareils pour votre mappage enregistré. |
| **Échec** | La dernière opération a échoué — consultez les indications d’erreur. |
Un **badge d’état** (Connecté, Dégradé, Injoignable) indique si Dispel peut actuellement joindre l’appliance Forescout.
## Dépannage
Si une synchronisation ou un test de connexion échoue, Dispel classe l’erreur et suggère une solution :
| Erreur | Ce que cela signifie généralement et comment le corriger |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Échec de l’authentification** | Le nom d’utilisateur ou le mot de passe de l’API Web a été rejeté. Vérifiez que l’utilisateur 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 du Enterprise Manager et assurez-vous que l’IP de Dispel est autorisée dans votre pare-feu. |
| **Erreur de certificat** | L’appliance a présenté un certificat TLS non approuvé. 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 — souvent en raison de la latence réseau ou d’une règle de pare-feu entre Dispel et votre réseau. |
| **Erreur de configuration** | L’URL semble incorrecte ou l’API Web n’est pas activée sur l’appliance. Vérifiez à nouveau les paramètres de connexion. |
## Foire aux questions
S’agit-il de eyeControl, eyeSight ou eyeExtend ?
La plateforme Forescout est composée de modules sous la marque « eye » — eyeSight (visibilité), eyeControl (politique et contrôle), eyeExtend (intégrations tierces) et autres. Dispel se connecte à **eyeControl** via son **module eyeExtend Connect** API Web. Vous le configurez en pointant Dispel vers votre **Enterprise Manager** appliance, ce qui explique pourquoi le champ de connexion s’appelle **URL de l’Enterprise Manager**.
Puis-je connecter plus d’une appliance Forescout ?
Oui. Forescout prend en charge plusieurs intégrations, vous pouvez donc connecter plusieurs appliances côte à côte. Donnez à chacune un **nom d’affichage** nom distinct pour les distinguer.
Pourquoi Forescout n’affiche-t-il qu’un seul site ?
Une appliance Forescout représente un environnement unique, donc Dispel la modélise comme un seul site mappé à un seul Wicket — plutôt que comme une liste de sites à mapper individuellement.
Mon appliance utilise un certificat auto-signé. La connexion échouera-t-elle ?
Non, si vous activez **Autoriser les certificats auto-signés** dans les paramètres de connexion. Laissez-la désactivée lorsque votre appliance présente un certificat émis par une autorité de confiance.
La connexion à Forescout modifie-t-elle quelque chose sur mon appliance ?
Non. Dispel ne fait que lire l’API Web de Forescout. Il ne crée, ne modifie ni ne supprime jamais de données du côté de Forescout.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.dispel.com/documentation/documentation-fr/integrer-et-administrer/integrations/asset-discovery/forescout.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.