> 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/claroty-xdome.md).
# Claroty xDome
Verbinden Sie Claroty xDome über seine Cloud-API, um erkannte OT-, IoT- und IIoT-Geräte in Dispel zu übernehmen — angereichert mit Schwachstellenbefunden — zugeordnet zu einem Wicket.
## Überblick
Die Claroty-xDome-Integration ermöglicht es Dispel, die von xDome entdeckten OT-, IoT- und IIoT-Assets abzurufen und als Dispel-Geräte zu übernehmen, angereichert mit den Schwachstellenbefunden von xDome. Sie verbinden Ihren xDome-Tenant einmalig, ordnen ihn einer Dispel-Einrichtung und einem Wicket zu, und Dispel importiert die passenden Geräte und hält sie bei einer regelmäßigen Synchronisierung aktuell.
Claroty xDome ist eine cloudbasierte Asset-Discovery-Integration. Dispel authentifiziert sich mit einem API-Token an der xDome-API und liest ausschließlich daraus. Da ein xDome-Tenant eine einzelne Umgebung repräsentiert, behandelt Dispel ihn als einen einzigen Standort, den Sie einem einzelnen Wicket zuordnen — es gibt keine standortweise Liste, die abgearbeitet werden muss.
#### Was Dispel importiert
* Geräte, die xDome entdeckt hat, mit Ihren vorhandenen Dispel-Geräten abgeglichen und als neue Geräte importiert, wenn es keine Übereinstimmung gibt.
* Die Schwachstellenbefunde von xDome (CVE-basiert, mit CVSS-v3-Bewertungen) als Befunde an den passenden Geräten, sodass Sie die bekannten Probleme eines Geräts sehen können, ohne Dispel zu verlassen.
{% hint style="info" %}
**Wo Sie es finden.** Melden Sie sich als Organisationsadministrator an und öffnen Sie [**Einstellungen → Integrationen**](https://app.dispel.com/settings/integrations). Claroty xDome erscheint in der **Bereich Asset Discovery / Network Visibility** . Klicken Sie **Verbinden** auf der Claroty-xDome-Karte, um zu beginnen.
{% endhint %}
## Bevor Sie beginnen
Sie benötigen Folgendes von xDome:
* Einen **API-Token**. Gehen Sie in xDome zu **Einstellungen → Admin-Einstellungen → Benutzerverwaltung**, erstellen Sie einen API-Benutzer und generieren Sie dann einen Token dafür.
* Ihr regionsspezifischer **xDome-API-Host** — zum Beispiel `https://api.claroty.com` oder `https://eu.api.claroty.com`.
{% hint style="warning" %}
**Das API-Token wird nur einmal angezeigt.** xDome zeigt den Token nur an, wenn Sie ihn generieren. Kopieren Sie ihn dann; wenn Sie ihn verlieren, generieren Sie einen neuen.
{% endhint %}
{% hint style="info" %}
**Die Berechtigungen des Tokens bestimmen, was Dispel sieht.** Dispel importiert die Assets, die der API-Benutzer lesen darf. Geben Sie dem API-Benutzer daher Zugriff auf die Standorte, deren Geräte Sie in Dispel haben möchten.
{% endhint %}
## Verbindung mit Claroty xDome
1. Gehen Sie zu [**Einstellungen → Integrationen**](https://app.dispel.com/settings/integrations) und klicken Sie **Verbinden** auf der Claroty-xDome-Karte.
2. Optional können Sie einen **Anzeigenamen** um diese Integration von anderen zu unterscheiden (Sie können mehr als eine Instanz verbinden).
3. Füllen Sie die Verbindungsfelder aus:
| Feld | Typ | Hinweise |
| ----------------------------------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **API-URL** | Konfiguration | Ihr regionsspezifischer xDome-API-Host, z. B. `https://api.claroty.com` oder `https://eu.api.claroty.com`. |
| **API-Token** | Anmeldedaten | Der für einen API-Benutzer in xDome generierte Token. Wird verschlüsselt gespeichert und nie wieder angezeigt. |
| **Außer Betrieb genommene Geräte einschließen** | Konfiguration | Optional. Wenn aktiviert, importiert Dispel auch Geräte, die xDome als außer Betrieb genommen markiert hat. Standardmäßig deaktiviert. |
4. Klicken Sie auf **Verbindung testen** um zu bestätigen, dass Dispel sich authentifizieren kann. Beheben Sie jeden gemeldeten Fehler, bevor Sie speichern.
5. Klicken Sie auf **Speichern**. Dispel speichert die Integration und führt sofort die erste Synchronisierung aus.
{% hint style="info" %}
**Ihre Anmeldedaten sind verschlüsselt.** Das API-Token ist im Ruhezustand verschlüsselt und wird nach dem Speichern nie wieder angezeigt. Wenn Sie später bearbeiten, lassen Sie das Token-Feld leer, um den gespeicherten Wert beizubehalten.
{% endhint %}
## Zuordnung des Tenants zu einem Wicket
Sobald die erste Synchronisierung abgeschlossen ist, öffnen Sie die Integration, um den **Bereich Standortzuordnung** Abschnitt. Claroty xDome erscheint als ein einzelner Standort, der Ihren Tenant repräsentiert.
> Ordnen Sie jeden Anbieter-Standort einer Dispel-Einrichtung und einem Wicket zu. Geräte aus zugeordneten Standorten werden in Dispel synchronisiert.
1. Wählen Sie ein **Facility**.
2. Wählen Sie ein **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 Geräte von xDome in das zugeordnete Wicket und meldet dann, wie viele Geräte importiert wurden. Importierte Geräte erscheinen im zugeordneten Wicket zusammen mit allen von Ihnen manuell hinzugefügten Geräten, mit den zugehörigen Schwachstellenbefunden von xDome.
## Ihr Inventar aktuell halten
* Dispel synchronisiert automatisch in regelmäßigen Abständen neu, sodass neu entdeckte Geräte, geänderte Details und neue Befunde 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 den Token zu erneuern, bearbeiten Sie die Integration und verwenden Sie **Speichern & synchronisieren**. Lassen Sie das Token-Feld leer, um den aktuellen Token beizubehalten.
Die Schwachstellenbefunde werden bei jeder Synchronisierung aktualisiert, und Befunde, die xDome nicht mehr meldet, fallen automatisch weg.
## Verbindungsstatus
Jede Integration zeigt einen Status, damit Sie immer wissen, wie es steht:
| Status | Bedeutung |
| ------------------------------- | ---------------------------------------------------------------------------------------- |
| **Nicht initialisiert** | Gespeichert, aber die erste Synchronisierung wurde noch nicht ausgeführt. |
| **Wird initialisiert** | Die erste Synchronisierung wird ausgeführt. |
| **Bereit** | Verbunden und synchronisiert; die Zuordnung ist angewendet. |
| **Aktualisierung erforderlich** | Neue Anbieterdaten 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 **Status-Badge** (Verbunden, Beeinträchtigt, Unerreichbar) zeigt an, ob Dispel die xDome-API derzeit erreichen kann.
## Fehlerbehebung
Wenn eine Synchronisierung oder ein Verbindungstest fehlschlägt, klassifiziert Dispel den Fehler und schlägt eine Lösung vor:
| Fehler | Was es normalerweise bedeutet und wie Sie es beheben |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Authentifizierung fehlgeschlagen** | Das API-Token wurde abgelehnt. Bestätigen Sie, dass der API-Benutzer in xDome aktiv ist und dass der Token aktuell ist — er wird nur einmal angezeigt, also generieren Sie einen neuen, wenn er verloren gegangen ist. |
| **Endpunkt nicht erreichbar** | Dispel konnte xDome nicht erreichen. Überprüfen Sie, ob die API-URL Ihr korrekter regionsspezifischer Host ist (zum Beispiel `https://api.claroty.com` oder `https://eu.api.claroty.com`). |
| **Zeitüberschreitung bei der Verbindung** | xDome hat zu lange für die Antwort gebraucht — normalerweise ein vorübergehendes Netzwerkproblem; versuchen Sie es erneut. |
## Häufig gestellte Fragen
Wo erstelle ich das API-Token?
Gehen Sie in xDome zu **Einstellungen → Admin-Einstellungen → Benutzerverwaltung**, erstellen Sie einen API-Benutzer und generieren Sie einen Token dafür. Der Token wird nur einmal angezeigt, also kopieren Sie ihn, bevor Sie die Seite verlassen.
Welche API-URL soll ich verwenden?
Ihr regionsspezifischer xDome-API-Host, zum Beispiel `https://api.claroty.com` oder `https://eu.api.claroty.com`. Verwenden Sie den Host für die Region, in der Ihr xDome-Tenant läuft.
Welche Befunde bringt Claroty xDome in Dispel ein?
Die Schwachstellenbefunde von xDome — CVE-basiert, mit CVSS-v3-Bewertungen — werden an den passenden Geräten angehängt. Befunde werden bei jeder Synchronisierung aktualisiert, und alles, was xDome nicht mehr meldet, fällt automatisch weg.
Ändert Dispel etwas in xDome?
Nein. Die Integration ist nur lesend. Dispel zieht Inventar und Befunde, erstellt, ändert oder löscht jedoch niemals Daten in xDome.
Kann ich mehr als einen xDome-Tenant verbinden?
Ja. Claroty xDome unterstützt mehrere Integrationen, sodass Sie mehrere Tenants nebeneinander verbinden können. Geben Sie jedem einen eindeutigen **Anzeigenamen** Namen, um sie zu unterscheiden.
---
# 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/claroty-xdome.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.