> 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/dragos.md).
# Dragos
Verbinden Sie die Dragos Platform (SiteStore), um erkannte OT-Assets in Dispel zu übernehmen, Dragos-Sensoren den Wickets zuzuordnen und Gerätedaten sowie Schwachstellenbefunde synchron zu halten.
## Übersicht
Die Dragos-Integration ermöglicht es Dispel, die OT-Assets abzurufen, die die Dragos-Plattform entdeckt hat, und sie als Dispel-Geräte zu übernehmen. Sie verbinden sich mit Ihrem Dragos **SiteStore** einmal, ordnen jeden Dragos-Sensor einer Dispel-Einrichtung und einem Wicket zu, und Dispel importiert die passenden Geräte und hält sie bei einer wiederkehrenden Synchronisierung aktuell.
Dragos ist eine **Asset-Discovery** Integrationslösung. Dispel liest aus Dragos — es schreibt niemals zurück auf die Plattform.
In Dragos, **Sensoren** sind die Sammelpunkte, die Ihr industrielles Netzwerk überwachen. Dispel behandelt jeden Dragos-Sensor als eine **Standort** zuordnen, die Sie einem Dispel-Wicket zuweisen, sodass Assets sensorbasiert am richtigen Ort landen.
#### Was Dispel importiert
* Entdeckte Assets (Name, IP-Adresse, MAC-Adresse, Hersteller/Modell, Betriebssystem, Gerätetyp) als Dispel-Geräte.
* Beobachtete Netzwerkprotokolle und Ports für jedes Asset.
* Ein Link zurück zum Asset in Dragos, der auf dem Gerät gespeichert ist.
* **Schwachstellenbefunde** für jedes importierte Gerät — einschließlich sowohl Hardware/Firmware- als auch Software/Betriebssystem-Problemen — und wird bei jeder Synchronisierung aktualisiert.
{% hint style="info" %}
**Wo Sie es finden.** Melden Sie sich als Organisationsadministrator an und öffnen Sie **Einstellungen → Integrationen**. Dragos erscheint in der **Asset Discovery / Network Visibility** Bereich. Klicken Sie auf **Verbinden** auf der Dragos-Karte beginnen.
{% endhint %}
## Bevor Sie beginnen
Sie benötigen Folgendes aus Ihrem Dragos SiteStore:
* Einen **API-Schlüssel** — sein **API-Schlüssel-ID** (die Kennung) und **API-Schlüssel-Geheimnis**. Stellen Sie dies in SiteStore bereit.
* Die **SiteStore-URL** Ihrer Bereitstellung — zum Beispiel `https://customer.dragos.cloud`.
{% hint style="warning" %}
**Das API-Schlüssel-Geheimnis wird nur einmal angezeigt.** Dragos zeigt das Geheimnis nur einmal an, wenn Sie den Schlüssel bereitstellen. Kopieren Sie es dann — wenn Sie es verlieren, stellen Sie einen neuen Schlüssel bereit. Fügen Sie außerdem Dispels **Whitelist-IP** (auf dem Verbindungsformular angezeigt) zu Ihrer Firewall-Allowlist hinzu, damit Dispel SiteStore erreichen kann, insbesondere bei On-Premises-Bereitstellungen.
{% endhint %}
## Verbindung mit Dragos herstellen
1. Gehen Sie zu **Einstellungen → Integrationen** und klicken Sie **Verbinden** auf der Dragos-Karte.
2. Optional können Sie einen **Anzeigenamen** um diese Integration von anderen zu unterscheiden (Sie können mehr als einen SiteStore verbinden).
3. Füllen Sie die Verbindungsfelder aus:
| Feld | Typ | Hinweise |
| --------------------------- | ------------- | ---------------------------------------------------------------------------------------------------- |
| **SiteStore-URL** | Konfiguration | Die Basis-URL Ihrer Dragos-SiteStore-Instanz. |
| **API-Schlüssel-ID** | Anmeldedaten | Die API-Schlüssel-ID aus Ihrem Dragos SiteStore. |
| **API-Schlüssel-Geheimnis** | Anmeldedaten | Das mit dem Schlüssel verknüpfte Geheimnis. Wird verschlüsselt gespeichert und nie wieder angezeigt. |
4. Klicken Sie auf **Verbindung testen** um zu bestätigen, dass Dispel sich bei SiteStore authentifizieren kann. Beheben Sie alle gemeldeten Fehler, bevor Sie speichern.
5. Klicken Sie auf **Speichern**. Dispel speichert die Integration und führt sofort die erste Synchronisierung aus, um Ihre Sensoren zu erkennen.
{% hint style="info" %}
**Ihre Anmeldedaten sind verschlüsselt.** Das API-Schlüssel-Geheimnis wird im Ruhezustand verschlüsselt und nach dem Speichern nie wieder angezeigt. Wenn Sie später bearbeiten, lassen Sie die Anmeldefelder leer, um die gespeicherten Werte beizubehalten.
{% endhint %}
## Sensoren zu Wickets zuordnen
Wenn die erste Synchronisierung abgeschlossen ist, öffnen Sie die Integration, um den **Bereich Standortzuordnung** Abschnitt. Jeder Dragos-Sensor erscheint als Standort, und hier entscheiden Sie, welche Sensoren zu Dispel-Geräten werden und wo sie landen.
> Ordnen Sie jeden Herstellerstandort einer Dispel-Einrichtung und einem Wicket zu. Geräte aus zugeordneten Standorten werden in Dispel synchronisiert.
Für jeden Sensor, den Sie importieren möchten:
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 arbeitet jeden zugeordneten Sensor nacheinander ab — Sie sehen, wie der Fortschritt pro Standort von Warten über Abrufen und Synchronisieren bis hin zu Abgeschlossen wechselt — und meldet dann, wie viele Geräte importiert wurden (zum Beispiel, **"12 Geräte importiert"** oder eine Aufschlüsselung neuer gegenüber bereits importierter Geräte). Importierte Geräte erscheinen im zugeordneten Wicket zusammen mit allen Geräten, die Sie manuell hinzugefügt haben.
## Ihr Inventar aktuell halten
* Dispel **synchronisiert automatisch erneut** nach einem wiederkehrenden Zeitplan, sodass neu entdeckte Assets 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 Anmeldeinformationen leer, um das aktuelle Geheimnis beizubehalten.
## Schwachstellenbefunde
Dragos meldet bekannte Schwachstellen für die von ihm überwachten Assets. Nach jeder erfolgreichen Synchronisierung ruft Dispel die Schwachstellenbefunde für Ihre importierten Geräte ab — einschließlich sowohl Hardware/Firmware- als auch Software/Betriebssystem-Problemen — und fügt sie diesen Geräten hinzu, sodass Sie bekannte Probleme eines Geräts sehen können, ohne Dispel zu verlassen. Befunde werden bei jeder Synchronisierung aktualisiert, und behobene Befunde fallen automatisch weg.
## Verbindungsstatus
Jede Integration zeigt einen Status an, damit Sie immer wissen, wo sie steht:
| Status | Bedeutung |
| ------------------------------- | ------------------------------------------------------------------------------------------ |
| **Nicht initialisiert** | Gespeichert, aber die erste Synchronisierung wurde noch nicht ausgeführt. |
| **Initialisierung** | Ausführen der ersten Synchronisierung und Erkennen von Sensoren. |
| **Bereit** | Verbunden und synchronisiert; Zuordnungen werden 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 gespeicherten Zuordnungen importieren. |
| **Fehlgeschlagen** | Der letzte Vorgang ist fehlgeschlagen — siehe die Hinweise zum Fehler. |
Eine separate **Statusanzeige** (Verbunden, Beeinträchtigt, Unerreichbar) spiegelt wider, ob Dispel die Dragos-API 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** | Die API-Schlüssel-ID/das Geheimnis wurde abgelehnt. Der Schlüssel wurde möglicherweise rotiert, ist abgelaufen oder widerrufen worden — stellen Sie einen neuen bereit und aktualisieren Sie die Integration. |
| **Endpunkt nicht erreichbar** | Dispel konnte SiteStore nicht erreichen. Überprüfen Sie die SiteStore-URL und ob die IP von Dispel in Ihrer Firewall allowlisted ist. |
| **Verbindungszeitüberschreitung** | SiteStore hat zu lange gebraucht, um zu antworten — oft Netzwerk-Latenz oder eine Firewall-Regel. |
| **Drosselung** | Dragos hat Anfragen gedrosselt. Die nächste geplante Synchronisierung sollte erfolgreich sein. |
| **Konfigurationsfehler** | Die SiteStore-URL sieht falsch aus. Überprüfen Sie die Verbindungseinstellungen erneut. |
## Häufig gestellte Fragen
Kann ich mehr als einen Dragos SiteStore verbinden?
Ja. Dragos unterstützt mehrere Integrationen, sodass Sie mehrere SiteStore-Instanzen nebeneinander verbinden können. Geben Sie jeder einen eindeutigen **Anzeigenamen** zur Unterscheidung.
Was ist ein „Standort“ bei Dragos?
Dispel ordnet Dragos **Sensoren** Standorten zu. Jeder Sensor, der Ihr Netzwerk überwacht, erscheint in der Standortzuordnungsliste, sodass Sie Assets von verschiedenen Sensoren zu verschiedenen Einrichtungen und Wickets leiten können.
Ich habe mein API-Schlüssel-Geheimnis verloren. Was soll ich tun?
Dragos zeigt das Geheimnis nur einmal zum Zeitpunkt der Bereitstellung an. Wenn Sie es nicht mehr haben, stellen Sie einen neuen API-Schlüssel in SiteStore bereit und aktualisieren Sie die Integration mit der neuen ID und dem neuen Geheimnis.
Ändert sich durch das Verbinden von Dragos etwas in SiteStore?
Nein. Dispel liest nur aus Dragos. Es erstellt, ändert oder löscht niemals Daten auf der Dragos-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/dragos.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.