> 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-nl/integreren-en-beheren/integrations/asset-discovery/forescout.md).
# Forescout
Verbind Forescout eyeControl via de Web API op je Enterprise Manager-appliance om ontdekte hosts als apparaten in Dispel binnen te halen — gekoppeld aan een Wicket en vernieuwd via een terugkerende synchronisatie.
## Overzicht
De Forescout-integratie laat Dispel de hosts ophalen die Forescout in uw netwerk heeft ontdekt en ze als Dispel-apparaten importeren. U maakt één keer verbinding met uw Forescout-appliance, koppelt deze aan een Dispel-facility en Wicket, en Dispel importeert de overeenkomende apparaten en houdt ze actueel via een terugkerende synchronisatie.
Forescout is een on-premise **assetdetectie** integratie. Concreet integreert Dispel met **Forescout eyeControl** via de Web API (de **eyeExtend Connect** module), en leest er alleen uit. U wijst Dispel naar uw **Enterprise Manager** — Forescouts centrale beheerappliance, die de afzonderlijke Forescout-appliances in uw netwerk samenvoegt. U implementeert en beheert de Enterprise Manager zelf (als fysieke of virtuele appliance), dus het is geen cloudservice die door Forescout wordt gehost — Dispel bereikt deze op een adres binnen uw eigen omgeving, daarom gebruikt de verbinding vaak een privé-URL en de optie voor zelfondertekende certificaten.
Omdat de Enterprise Manager één enkele omgeving vertegenwoordigt, behandelt Dispel deze als één **site** die u koppelt aan één Wicket — er is geen lijst per site om door te werken.
{% hint style="info" %}
**Een opmerking over Forescout-namen.** "eyeControl" is het Forescout-product waarmee Dispel verbinding maakt; "Enterprise Manager" is de beheerappliance waarnaar u Dispel laat verwijzen. Het verbindingsveld heeft het label **Enterprise Manager-URL** om overeen te komen met de bewoording in de Forescout-console.
{% endhint %}
#### Wat Dispel importeert
* Ontdekte hosts (naam, IP-adres, MAC-adres, merk/model, besturingssysteem, apparaattype) als Dispel-apparaten.
* Geobserveerde netwerkprotocollen en poorten voor elke host.
* Een terugkoppeling naar de host in Forescout, opgeslagen op het apparaat.
{% hint style="info" %}
**Waar u het vindt.** Meld u aan als organisatiebeheerder en open **Instellingen → Integraties**. Forescout verschijnt in de **Assetdetectie / netwerkzichtbaarheid** sectie. Klik op **Verbinden** op de Forescout-kaart om te beginnen.
{% endhint %}
## Voordat u begint
U hebt het volgende nodig uit uw Forescout-console:
* Een **Web API-gebruiker** — maak er een aan onder **Hulpmiddelen → Opties → Web API → Gebruikersinstellingen**. Dispel verifieert zich met de **Gebruikersnaam** en **Wachtwoord**.
* De **Enterprise Manager-URL** van uw appliance — bijvoorbeeld `https://192.168.1.100`.
* Als uw appliance gebruikmaakt van een **zelfondertekend TLS-certificaat**, wees dan voorbereid om tijdens de installatie de optie voor zelfondertekende certificaten in te schakelen.
{% hint style="warning" %}
**Zet het IP-adres van Dispel op de allowlist.** Wanneer u het verbindingsformulier opent, toont Dispel een **Whitelist-IP** waarde. Voeg dit adres toe aan de allowlist van uw netwerkfirewall, zodat Dispel de on-premise appliance kan bereiken.
{% endhint %}
## Forescout verbinden
1. Ga naar **Instellingen → Integraties** en klik **Verbinden** op de Forescout-kaart.
2. Stel optioneel een **Weergavenaam** in om deze integratie van andere te onderscheiden (u kunt meer dan één appliance verbinden).
3. Vul de verbindingsvelden in:
| Veld | Type | Opmerkingen |
| ------------------------------------------ | ------------- | -------------------------------------------------------------------------------------------- |
| **Enterprise Manager-URL** | Configuratie | De URL van uw Forescout Enterprise Manager-appliance. |
| **Zelfondertekende certificaten toestaan** | Configuratie | Schakel in als uw appliance een zelfondertekend TLS-certificaat gebruikt. |
| **Gebruikersnaam** | Inloggegevens | De Web API-gebruiker die in de Forescout-console is aangemaakt. |
| **Wachtwoord** | Inloggegevens | Het wachtwoord van de Web API-gebruiker. Wordt versleuteld opgeslagen en nooit meer getoond. |
4. Klik op **Verbinding testen** om te bevestigen dat Dispel zich kan verifiëren bij de appliance. Los eventuele gemelde fouten op voordat u opslaat.
5. Klik op **Opslaan**. Dispel slaat de integratie op en voert onmiddellijk de eerste synchronisatie uit.
{% hint style="info" %}
**Uw inloggegevens zijn versleuteld.** Het wachtwoord is versleuteld in opgeslagen toestand en wordt na het opslaan nooit meer weergegeven. Laat bij later bewerken de inloggegevensvelden leeg om de opgeslagen waarden te behouden.
{% endhint %}
## De appliance aan een Wicket koppelen
Zodra de eerste synchronisatie is voltooid, opent u de integratie om de **Sitekoppeling** sectie te vinden. Forescout verschijnt als één enkele site die uw appliance vertegenwoordigt.
> Koppel elke vendorsite aan een Dispel-facility en wicket. Apparaten van gekoppelde sites worden gesynchroniseerd naar Dispel.
1. Kies een **Facility**.
2. Kies een **Wicket**. Als de facility slechts één Wicket heeft, selecteert Dispel die voor u.
3. Klik op **Koppelingen opslaan en importeren**.
Dispel importeert de hosts van de appliance in de gekoppelde Wicket — u ziet de voortgang bewegen van wachten, naar ophalen, naar synchroniseren, naar voltooid — en meldt vervolgens hoeveel apparaten zijn geïmporteerd (bijvoorbeeld, **"12 apparaten geïmporteerd"** of een uitsplitsing van nieuwe versus al geïmporteerde apparaten). Geïmporteerde apparaten verschijnen in de gekoppelde Wicket naast eventuele apparaten die u handmatig hebt toegevoegd.
## Uw inventaris actueel houden
* Dispel **synchroniseert automatisch opnieuw** volgens een terugkerend schema, zodat nieuw ontdekte hosts en gewijzigde details worden opgepikt zonder dat u iets hoeft te doen.
* Om de nieuwste inventaris onmiddellijk op te halen, opent u de integratie en kiest u **Vernieuwen**.
* Om verbindingsgegevens te wijzigen of inloggegevens te roteren, bewerkt u de integratie en gebruikt u **Opslaan en synchroniseren**. Laat de inloggegevensvelden leeg om het huidige wachtwoord te behouden.
## Verbindingsstatus
Elke integratie toont een status, zodat u altijd weet hoe het ervoor staat:
| Status | Betekenis |
| ------------------------------ | -------------------------------------------------------------------------------------------- |
| **Niet geïnitialiseerd** | Opgeslagen, maar de eerste synchronisatie is nog niet uitgevoerd. |
| **Initialiseren** | De eerste synchronisatie wordt uitgevoerd. |
| **Gereed** | Verbonden en gesynchroniseerd; de koppeling is toegepast. |
| **Vernieuwing vereist** | Er zijn nieuwe leveranciersgegevens beschikbaar; voer een vernieuwing uit om ze op te halen. |
| **Bezig met vernieuwen** | Er loopt een synchronisatie. |
| **Wijzigingen in behandeling** | Wijzigingen in de koppeling zijn opgeslagen maar nog niet toegepast. |
| **Toepassen** | Apparaten importeren voor uw opgeslagen koppeling. |
| **Mislukt** | De laatste bewerking is mislukt — zie de foutaanwijzingen. |
Een afzonderlijke **gezondheidsbadge** (Verbonden, Verminderd, Onbereikbaar) geeft aan of Dispel de Forescout-appliance momenteel kan bereiken.
## Probleemoplossing
Als een synchronisatie of verbindingstest mislukt, classificeert Dispel de fout en stelt het een oplossing voor:
| Fout | Wat het meestal betekent en hoe u het oplost |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Verificatie mislukt** | De gebruikersnaam of het wachtwoord van de Web API is geweigerd. Controleer of de Web API-gebruiker bestaat en of het wachtwoord actueel is. |
| **Eindpunt onbereikbaar** | Dispel kon de appliance niet bereiken. Controleer de Enterprise Manager-URL en of het IP-adres van Dispel op de allowlist in uw firewall staat. |
| **Certificaatfout** | De appliance presenteerde een niet-vertrouwd TLS-certificaat. Als deze een zelfondertekend certificaat gebruikt, schakel **Zelfondertekende certificaten toestaan** in in de verbindingsinstellingen. |
| **Verbindings-time-out** | De appliance deed te lang over het reageren — vaak door netwerklatentie of een firewallregel tussen Dispel en uw netwerk. |
| **Configuratiefout** | De URL lijkt onjuist of de Web API is niet ingeschakeld op de appliance. Controleer de verbindingsinstellingen opnieuw. |
## Veelgestelde vragen
Is dit eyeControl, eyeSight of eyeExtend?
Het Forescout-platform bestaat uit modules onder het "eye"-merk — eyeSight (zichtbaarheid), eyeControl (beleid en beheer), eyeExtend (integraties van derden) en andere. Dispel maakt verbinding met **eyeControl** via zijn **eyeExtend Connect** Web API. U configureert het door Dispel naar uw **Enterprise Manager** appliance te laten verwijzen, daarom heet het verbindingsveld **Enterprise Manager-URL**.
Kan ik meer dan één Forescout-appliance verbinden?
Ja. Forescout ondersteunt meerdere integraties, zodat u meerdere appliances naast elkaar kunt verbinden. Geef elk een unieke **Weergavenaam** om ze van elkaar te onderscheiden.
Waarom toont Forescout slechts één site?
Een Forescout-appliance vertegenwoordigt één enkele omgeving, dus Dispel modelleert dit als één site die aan één Wicket is gekoppeld — in plaats van een lijst met sites die afzonderlijk moeten worden gekoppeld.
Mijn appliance gebruikt een zelfondertekend certificaat. Zal de verbinding mislukken?
Niet als u **Zelfondertekende certificaten toestaan** in de verbindingsinstellingen inschakelt. Laat het uitgeschakeld wanneer uw appliance een certificaat van een vertrouwde autoriteit presenteert.
Verandert het verbinden van Forescout iets op mijn appliance?
Nee. Dispel leest alleen uit de Web API van Forescout. Het maakt, wijzigt of verwijdert nooit gegevens aan de Forescout-kant.
---
# 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-nl/integreren-en-beheren/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.