> 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.

## Présentation

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.

{% hint style="info" %}
**À propos des noms Forescout.** « eyeControl » est le produit Forescout auquel Dispel se connecte ; « Enterprise Manager » est l’appliance de gestion dont vous indiquez l’adresse à Dispel. Le champ de connexion est intitulé **URL de l’Enterprise Manager** pour reprendre la terminologie de la console Forescout.
{% endhint %}

#### Données importées par Dispel

* 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.

{% hint style="info" %}
**Où la trouver.** Connectez-vous en tant qu’administrateur de l’organisation, puis ouvrez **Settings → Integrations**. Forescout apparaît dans la section **Asset Discovery / Network Visibility** . Cliquez sur **Connect** sur la carte Forescout pour commencer.
{% endhint %}

## Avant de commencer

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.

{% hint style="warning" %}
**Ajoutez l’adresse IP de Dispel à la liste d’autorisation.** Lorsque vous ouvrez le formulaire de connexion, Dispel affiche une **adresse IP à autoriser** value. Ajoutez cette adresse à la liste d’autorisation du pare-feu de votre réseau pour que Dispel puisse accéder à l’appliance sur site.
{% endhint %}

## Connexion de 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          | Remarques                                                                                                        |
| ----------------------------------------- | ------------- | ---------------------------------------------------------------------------------------------------------------- |
| **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.                                                       |
| **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é. |

4. 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.
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 ne s’affiche plus après son enregistrement. Lors d’une modification ultérieure, laissez les champs d’identifiants vides pour conserver les valeurs enregistrées.
{% endhint %}

## Associer l’appliance à un wicket

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.

1. Sélectionnez un **Établissement**.
2. Sélectionnez un **Wicket**. Si l’établissement ne possède qu’un seul wicket, Dispel le sélectionne automatiquement.
3. 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.

## Maintenir votre inventaire à jour

* 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.

## État de la connexion

Chaque intégration affiche un état pour que vous sachiez toujours où elle en est :

| État                         | Signification                                                                                       |
| ---------------------------- | --------------------------------------------------------------------------------------------------- |
| **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**   | 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.                  |

Un indicateur d’état distinct **de la connexion** (Connectée, Dégradée, 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                                | Signification habituelle et solution                                                                                                                                               |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **É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**           | L’URL semble incorrecte ou l’API Web n’est pas activée sur l’appliance. Vérifiez à nouveau les paramètres de connexion.                                                            |

## Questions fréquentes

<details>

<summary>S’agit-il d’eyeControl, d’eyeSight ou d’eyeExtend ?</summary>

La plateforme Forescout est composée de modules de la gamme « eye » — eyeSight (visibilité), eyeControl (politiques et contrôle), eyeExtend (intégrations tierces), entre autres. Dispel se connecte à **eyeControl** par l’intermédiaire de son **eyeExtend Connect** API Web. Vous le configurez en indiquant à Dispel votre **Enterprise Manager** appliance, d’où le nom du champ de connexion : **URL d’Enterprise Manager**.

</details>

<details>

<summary>Puis-je connecter plusieurs appliances Forescout ?</summary>

Oui. Forescout prend en charge plusieurs intégrations : vous pouvez donc connecter plusieurs appliances côte à côte. Attribuez à chacune un **nom d’affichage** distinct pour les différencier.

</details>

<details>

<summary>Pourquoi Forescout n’affiche-t-il qu’un seul site ?</summary>

Une appliance Forescout représente un seul environnement. Dispel la modélise donc comme un site associé à un seul Wicket, plutôt que comme une liste de sites à associer individuellement.

</details>

<details>

<summary>Mon appliance utilise un certificat autosigné. La connexion échouera-t-elle ?</summary>

Non, si vous activez l’option **Autoriser les certificats autosignés** dans les paramètres de connexion. Laissez-la désactivée si votre appliance présente un certificat délivré par une autorité de confiance.

</details>

<details>

<summary>La connexion à Forescout modifie-t-elle quoi que ce soit sur mon appliance ?</summary>

Non. Dispel ne fait que lire les données de l’API Web de Forescout. Elle ne crée, ne modifie et ne supprime jamais de données du côté de Forescout.

</details>


---

# 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=<question>&goal=<user_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.
