> 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-de/integrieren-and-administrieren/integrations/asset-discovery/forescout.md).
# Forescout
Verbinden Sie Forescout eyeControl über seine Web-API auf Ihrer Enterprise-Manager-Appliance, um erkannte Hosts als Geräte in Dispel zu übernehmen – einem Wicket zugeordnet und bei einer wiederkehrenden Synchronisierung aktualisiert.
## Überblick
Die Forescout-Integration ermöglicht es Dispel, die Hosts abzurufen, die Forescout in Ihrem Netzwerk entdeckt hat, und sie als Dispel-Geräte zu übernehmen. Sie verbinden Ihre Forescout-Appliance einmalig, ordnen sie einer Dispel-Einrichtung und einem Wicket zu, und Dispel importiert die passenden Geräte und hält sie bei einer wiederkehrenden Synchronisierung aktuell.
Forescout ist eine lokale **Asset-Erkennungs-** Integration. Genauer gesagt integriert sich Dispel mit **Forescout eyeControl** über seine Web-API (das **eyeExtend Connect** Modul) und liest nur daraus. Sie richten Dispel auf Ihren **Enterprise Manager** — Forescouts zentrale Verwaltungs-Appliance, die die einzelnen Forescout-Appliances in Ihrem Netzwerk zusammenführt. Sie stellen den Enterprise Manager selbst bereit und betreiben ihn (als physische oder virtuelle Appliance), daher ist er kein von Forescout gehosteter Cloud-Dienst — Dispel erreicht ihn unter einer Adresse innerhalb Ihrer eigenen Umgebung, weshalb die Verbindung oft eine private URL und die Option für selbstsignierte Zertifikate verwendet.
Da der Enterprise Manager eine einzelne Umgebung repräsentiert, behandelt Dispel ihn als eine **Site** die Sie einem einzigen Wicket zuordnen — es gibt keine standortweise Liste, die Sie durchgehen müssen.
{% hint style="info" %}
**Ein Hinweis zu den Forescout-Namen.** "eyeControl" ist das Forescout-Produkt, mit dem Dispel eine Verbindung herstellt; "Enterprise Manager" ist die Verwaltungs-Appliance, auf die Sie Dispel verweisen. Das Verbindungsfeld ist beschriftet mit **Enterprise Manager URL** um die Bezeichnung in der Forescout-Konsole widerzuspiegeln.
{% endhint %}
#### Was Dispel importiert
* Entdeckte Hosts (Name, IP-Adresse, MAC-Adresse, Hersteller/Modell, Betriebssystem, Gerätetyp) als Dispel-Geräte.
* Beobachtete Netzwerkprotokolle und Ports für jeden Host.
* Ein Verweis zurück zum Host in Forescout, auf dem Gerät gespeichert.
{% hint style="info" %}
**Wo Sie es finden.** Melden Sie sich als Organisationsadministrator an und öffnen Sie **Einstellungen → Integrationen**. Forescout erscheint im **Asset-Erkennung / Netzwerktransparenz** Bereich. Klicken Sie auf **Verbinden** auf der Forescout-Karte, um zu beginnen.
{% endhint %}
## Bevor Sie beginnen
Sie benötigen Folgendes aus Ihrer Forescout-Konsole:
* Ein **Web-API-Benutzer** — erstellen Sie einen unter **Tools → Options → Web API → User Settings**. Dispel authentifiziert sich mit dem **Benutzernamen** und **Passwort**.
* Die **Enterprise Manager URL** Ihrer Appliance — zum Beispiel `https://192.168.1.100`.
* Wenn Ihre Appliance ein **selbstsigniertes TLS-Zertifikat**verwendet, aktivieren Sie während der Einrichtung die Option für selbstsignierte Zertifikate.
{% hint style="warning" %}
**Dispel auf die Allowlist setzen.** Wenn Sie das Verbindungsformular öffnen, zeigt Dispel einen **IP auf der Whitelist** Wert an. Fügen Sie diese Adresse zu Ihrer Firewall-Allowlist hinzu, damit Dispel die lokale Appliance erreichen kann.
{% endhint %}
## Forescout verbinden
1. Gehen Sie zu **Einstellungen → Integrationen** und klicken Sie **Verbinden** auf der Forescout-Karte.
2. Optional können Sie einen **Anzeigenamen** festlegen, um diese Integration von anderen zu unterscheiden (Sie können mehr als eine Appliance verbinden).
3. Füllen Sie die Verbindungsfelder aus:
| Feld | Typ | Hinweise |
| ---------------------------------------- | ------------- | --------------------------------------------------------------------------------------- |
| **Enterprise Manager URL** | Konfiguration | Die URL Ihrer Forescout Enterprise-Manager-Appliance. |
| **Selbstsignierte Zertifikate zulassen** | Konfiguration | Aktivieren Sie dies, wenn Ihre Appliance ein selbstsigniertes TLS-Zertifikat verwendet. |
| **Benutzernamen** | Anmeldedaten | Der in der Forescout-Konsole erstellte Web-API-Benutzer. |
| **Passwort** | Anmeldedaten | Das Passwort des Web-API-Benutzers. Verschlüsselt gespeichert und nie wieder angezeigt. |
4. Klicken Sie auf **Verbindung testen** um zu bestätigen, dass Dispel sich bei der Appliance authentifizieren kann. Beheben Sie jeden gemeldeten Fehler vor dem Speichern.
5. Klicken Sie auf **Speichern**. Dispel speichert die Integration und führt sofort die erste Synchronisierung aus.
{% hint style="info" %}
**Ihre Anmeldedaten werden verschlüsselt.** Das Passwort wird im Ruhezustand verschlüsselt und nach dem Speichern nie wieder angezeigt. Wenn Sie später bearbeiten, lassen Sie die Anmeldedatenfelder leer, um die gespeicherten Werte beizubehalten.
{% endhint %}
## Die Appliance einem Wicket zuordnen
Sobald die erste Synchronisierung abgeschlossen ist, öffnen Sie die Integration, um den Bereich **Site-Zuordnung** zu finden. Forescout erscheint als eine einzelne Site, die Ihre Appliance repräsentiert.
> Ordnen Sie jede Anbieter-Site einer Dispel-Einrichtung und einem Wicket zu. Geräte aus zugeordneten Sites werden in Dispel synchronisiert.
1. Wählen Sie eine **Einrichtung**.
2. Wählen Sie eine **Wicket**. Wenn die Einrichtung nur ein Wicket hat, wählt Dispel es für Sie aus.
3. Klicken Sie auf **Zuordnungen speichern & importieren**.
Dispel importiert die Hosts der Appliance in das zugeordnete Wicket — Sie sehen den Fortschritt von Wartend über Abrufen und Synchronisieren bis Abgeschlossen — und meldet dann, wie viele Geräte importiert wurden (zum Beispiel, **"12 Geräte importiert"** oder eine Aufschlüsselung in neue und bereits importierte Geräte). Importierte Geräte erscheinen im zugeordneten Wicket neben allen Geräten, die Sie manuell hinzugefügt haben.
## Ihr Inventar aktuell halten
* Dispel **synchronisiert automatisch neu** nach einem wiederkehrenden Zeitplan, sodass neu entdeckte Hosts und geänderte Details ohne Ihr Zutun übernommen werden.
* Um das neueste Inventar sofort abzurufen, öffnen Sie die Integration und wählen Sie **Aktualisieren**.
* Um Verbindungsdetails zu ändern oder Anmeldedaten zu rotieren, bearbeiten Sie die Integration und verwenden Sie **Speichern & synchronisieren**. Lassen Sie die Anmeldedatenfelder leer, um das aktuelle Passwort beizubehalten.
## Verbindungsstatus
Jede Integration zeigt einen Status an, damit Sie immer wissen, wie sie steht:
| Status | Bedeutung |
| ------------------------------- | ------------------------------------------------------------------------------------------ |
| **Nicht initialisiert** | Gespeichert, aber die erste Synchronisierung wurde noch nicht ausgeführt. |
| **Wird initialisiert** | Führt die erste Synchronisierung aus. |
| **Bereit** | Verbunden und synchronisiert; die Zuordnung ist angewendet. |
| **Aktualisierung erforderlich** | Neue Herstellerdaten sind verfügbar; führen Sie eine Aktualisierung aus, um sie abzurufen. |
| **Wird aktualisiert** | Eine Synchronisierung läuft. |
| **Ausstehende Änderungen** | Zuordnungsänderungen sind gespeichert, aber noch nicht angewendet. |
| **Wird angewendet** | Geräte für Ihre gespeicherte Zuordnung werden importiert. |
| **Fehlgeschlagen** | Der letzte Vorgang ist fehlgeschlagen — siehe die Fehlerhinweise. |
Ein separates **Gesundheits-Badge** (Verbunden, Beeinträchtigt, Nicht erreichbar) zeigt an, ob Dispel die Forescout-Appliance derzeit erreichen kann.
## Fehlerbehebung
Wenn eine Synchronisierung oder ein Verbindungs-test fehlschlägt, klassifiziert Dispel den Fehler und schlägt eine Lösung vor:
| Fehler | Was er normalerweise bedeutet und wie man ihn behebt |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Authentifizierung fehlgeschlagen** | Der Web-API-Benutzername oder das Passwort wurde abgelehnt. Bestätigen Sie, dass der Web-API-Benutzer vorhanden ist und das Passwort aktuell ist. |
| **Endpunkt nicht erreichbar** | Dispel konnte die Appliance nicht erreichen. Überprüfen Sie die Enterprise-Manager-URL und ob die IP von Dispel in Ihrer Firewall auf der Allowlist steht. |
| **Zertifikatsfehler** | Die Appliance hat ein nicht vertrauenswürdiges TLS-Zertifikat vorgelegt. Wenn sie ein selbstsigniertes Zertifikat verwendet, aktivieren Sie **Selbstsignierte Zertifikate zulassen** in den Verbindungseinstellungen. |
| **Verbindungszeitüberschreitung** | Die Appliance hat zu lange gebraucht, um zu antworten — häufig Netzwerklatenz oder eine Firewall-Regel zwischen Dispel und Ihrem Netzwerk. |
| **Konfigurationsfehler** | Die URL sieht falsch aus oder die Web-API ist auf der Appliance nicht aktiviert. Überprüfen Sie die Verbindungseinstellungen erneut. |
## Häufig gestellte Fragen
Ist dies eyeControl, eyeSight oder eyeExtend?
Die Plattform von Forescout besteht aus Modulen unter der Marke "eye" — eyeSight (Sichtbarkeit), eyeControl (Richtlinien und Steuerung), eyeExtend (Integrationen von Drittanbietern) und andere. Dispel verbindet sich mit **eyeControl** über seine **eyeExtend Connect** Web-API. Sie konfigurieren sie, indem Sie Dispel auf Ihre **Enterprise Manager** Appliance verweisen, weshalb das Verbindungsfeld heißt **Enterprise Manager URL**.
Kann ich mehr als eine Forescout-Appliance verbinden?
Ja. Forescout unterstützt mehrere Integrationen, sodass Sie mehrere Appliances nebeneinander verbinden können. Geben Sie jeder einen eindeutigen **Anzeigenamen** Namen,
Warum zeigt Forescout nur eine Site an?
Eine Forescout-Appliance repräsentiert eine einzelne Umgebung, daher modelliert Dispel sie als eine Site, die einem Wicket zugeordnet ist — und nicht als Liste von Sites, die einzeln zugeordnet werden müssen.
Meine Appliance verwendet ein selbstsigniertes Zertifikat. Wird die Verbindung fehlschlagen?
Nicht, wenn Sie **Selbstsignierte Zertifikate zulassen** in den Verbindungseinstellungen aktivieren. Lassen Sie es deaktiviert, wenn Ihre Appliance ein Zertifikat von einer vertrauenswürdigen Stelle präsentiert.
Ändert die Verbindung zu Forescout etwas an meiner Appliance?
Nein. Dispel liest nur aus Forescouts Web-API. Es erstellt, ändert oder löscht niemals Daten auf der Forescout-Seite.
---
# 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-de/integrieren-and-administrieren/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.