> 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/claroty-xdome.md).

# Claroty xDome

Verbind Claroty xDome via de cloud-API om ontdekte OT-, IoT- en IIoT-apparaten in Dispel binnen te halen — verrijkt met bevindingen over kwetsbaarheden — toegewezen aan een Wicket.

## Overzicht

De Claroty xDome-integratie laat Dispel de OT-, IoT- en IIoT-assets ophalen die xDome heeft ontdekt en ze importeren als Dispel-apparaten, verrijkt met xDome's kwetsbaarheidsbevindingen. Je verbindt je xDome-tenant één keer, koppelt die aan een Dispel-faciliteit en Wicket, en Dispel importeert de overeenkomende apparaten en houdt ze actueel via een terugkerende synchronisatie.

Claroty xDome is een cloudgebaseerde integratie voor het ontdekken van assets. Dispel authenticeert zich bij de xDome-API met een API-token en leest daar alleen van. Omdat een xDome-tenant één enkele omgeving vertegenwoordigt, behandelt Dispel die als één site die je aan één Wicket koppelt — er is geen lijst per site die je moet doorlopen.

#### Wat Dispel importeert

* Apparaten die xDome heeft ontdekt, gekoppeld aan je bestaande Dispel-apparaten en als nieuwe apparaten geïmporteerd waar geen overeenkomst is.
* xDome's kwetsbaarheidsbevindingen (op basis van CVE, met CVSS v3-scores) als bevindingen op de overeenkomende apparaten, zodat je de bekende problemen van een apparaat kunt zien zonder Dispel te verlaten.

{% hint style="info" %}
**Waar u het vindt.** Meld u aan als organisatiebeheerder en open [**Instellingen → Integraties**](https://app.dispel.com/settings/integrations). Claroty xDome verschijnt in de **Asset Discovery / Netwerkzichtbaarheid** sectie. Klik op **Verbinden** op de Claroty xDome-kaart om te beginnen.
{% endhint %}

## Voordat u begint

Je hebt het volgende van xDome nodig:

* Een **API-token**. Ga in xDome naar **Instellingen → Beheerinstellingen → Gebruikersbeheer**, maak een API-gebruiker aan en genereer vervolgens een token daarvoor.
* Je regiogebonden **xDome API-host** — bijvoorbeeld `https://api.claroty.com` of `https://eu.api.claroty.com`.

{% hint style="warning" %}
**Het API-token wordt één keer weergegeven.** xDome toont het token alleen wanneer je het genereert. Kopieer het dan; als je het kwijtraakt, genereer je een nieuwe.
{% endhint %}

{% hint style="info" %}
**De rechten van het token bepalen wat Dispel ziet.** Dispel importeert de assets die de API-gebruiker mag lezen, dus geef de API-gebruiker toegang tot de sites waarvan je de apparaten in Dispel wilt hebben.
{% endhint %}

## Verbinden met Claroty xDome

1. Ga naar [**Instellingen → Integraties**](https://app.dispel.com/settings/integrations) en klik op **Verbinden** op de Claroty xDome-kaart.
2. Stel optioneel een **weergavenaam** om deze integratie te onderscheiden van andere (u kunt meer dan één instantie verbinden).
3. Vul de verbindingsvelden in:

| Veld                             | Type       | Opmerkingen                                                                                                                |
| -------------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------- |
| **API-URL**                      | Config     | Je regiogebonden xDome API-host, bijvoorbeeld `https://api.claroty.com` of `https://eu.api.claroty.com`.                   |
| **API-token**                    | Referentie | Het token dat in xDome voor een API-gebruiker is gegenereerd. Versleuteld opgeslagen en nooit opnieuw weergegeven.         |
| **Verouderde apparaten opnemen** | Config     | Optioneel. Wanneer dit aan staat, importeert Dispel ook apparaten die xDome als verouderd heeft gemarkeerd. Standaard uit. |

4. Klik op **Verbinding testen** om te bevestigen dat Dispel kan authenticeren. Los eventuele gerapporteerde fout 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 API-token wordt opgeslagen in versleutelde vorm en wordt na het opslaan nooit opnieuw weergegeven. Laat bij het later bewerken het tokenveld leeg om de opgeslagen waarde te behouden.
{% endhint %}

## Tenant koppelen aan een Wicket

Nadat de eerste synchronisatie is voltooid, opent u de integratie om de **Site-mapping** sectie. Claroty xDome verschijnt als één site die je tenant vertegenwoordigt.

> Koppel elke leverancierssite aan een Dispel-faciliteit en Wicket. Apparaten van gekoppelde sites worden gesynchroniseerd naar Dispel.

1. Kies een **faciliteit**.
2. Kies een **wicket**. Als de faciliteit slechts één Wicket heeft, selecteert Dispel die automatisch voor u.
3. Klik op **Koppelingen opslaan en importeren**.

Dispel importeert de apparaten van xDome in het gekoppelde Wicket en rapporteert daarna hoeveel apparaten zijn geïmporteerd. Geïmporteerde apparaten verschijnen in het gekoppelde Wicket naast alle apparaten die je handmatig hebt toegevoegd, met de kwetsbaarheidsbevindingen van xDome eraan gekoppeld.

## Uw inventaris actueel houden

* Dispel synchroniseert automatisch opnieuw volgens een terugkerend schema, zodat nieuw ontdekte apparaten, gewijzigde details en nieuwe bevindingen worden opgepikt zonder dat jij iets hoeft te doen.
* Als u de nieuwste inventaris direct wilt ophalen, opent u de integratie en kiest u **Vernieuwen**.
* Om verbindingsgegevens te wijzigen of het token te roteren, bewerk je de integratie en gebruik je **Opslaan en synchroniseren**. Laat het tokenveld leeg om het huidige token te behouden.

Kwetsbaarheidsbevindingen worden bij elke synchronisatie vernieuwd, en bevindingen die xDome niet langer rapporteert verdwijnen automatisch.

## Verbindingsstatus

Elke integratie toont een status, zodat u altijd weet wat de stand van zaken is:

| Status                         | Betekenis                                                                                 |
| ------------------------------ | ----------------------------------------------------------------------------------------- |
| **Niet geïnitialiseerd**       | Opgeslagen, maar de eerste synchronisatie is nog niet uitgevoerd.                         |
| **Initialiseren**              | De eerste synchronisatie uitvoeren.                                                       |
| **Gereed**                     | Verbonden en gesynchroniseerd; de koppeling is toegepast.                                 |
| **Vernieuwing nodig**          | Nieuwe leveranciersgegevens zijn beschikbaar; voer een vernieuwing uit om ze op te halen. |
| **Vernieuwen**                 | Er is een synchronisatie bezig.                                                           |
| **Wijzigingen in behandeling** | Koppelingswijzigingen zijn opgeslagen, maar nog niet toegepast.                           |
| **Toepassen**                  | Apparaten importeren voor uw opgeslagen koppeling.                                        |
| **Mislukt**                    | De laatste bewerking is mislukt — zie de foutinstructies.                                 |

Een afzonderlijke **gezondheidsbadge** (Verbonden, Gedegradeerd, Onbereikbaar) geeft aan of Dispel op dit moment verbinding kan maken met de xDome-API.

## 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 kunt oplossen                                                                                                                                                      |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Authenticatie mislukt**         | Het API-token is geweigerd. Bevestig dat de API-gebruiker actief is in xDome en dat het token actueel is — het wordt maar één keer weergegeven, dus genereer een nieuw token als het verloren is gegaan. |
| **Eindpunt onbereikbaar**         | Dispel kon geen verbinding maken met xDome. Controleer of de API-URL je juiste regiogebonden host is (bijvoorbeeld `https://api.claroty.com` of `https://eu.api.claroty.com`).                           |
| **Verbindingsfout door time-out** | xDome deed te lang over het beantwoorden — meestal een tijdelijk netwerkprobleem; probeer het opnieuw.                                                                                                   |

## Veelgestelde vragen

<details>

<summary>Waar maak ik het API-token aan?</summary>

Ga in xDome naar **Instellingen → Beheerinstellingen → Gebruikersbeheer**, maak een API-gebruiker aan en genereer een token daarvoor. Het token wordt slechts één keer weergegeven, dus kopieer het voordat je de pagina verlaat.

</details>

<details>

<summary>Welke API-URL moet ik gebruiken?</summary>

Je regiogebonden xDome API-host, bijvoorbeeld `https://api.claroty.com` of `https://eu.api.claroty.com`. Gebruik de host voor de regio waarin je xDome-tenant draait.

</details>

<details>

<summary>Welke bevindingen brengt Claroty xDome in Dispel?</summary>

xDome's kwetsbaarheidsbevindingen — op basis van CVE, met CVSS v3-scores — gekoppeld aan de overeenkomende apparaten. Bevindingen worden bij elke synchronisatie vernieuwd, en alles wat xDome niet langer rapporteert verdwijnt automatisch.

</details>

<details>

<summary>Wijzigt Dispel iets in xDome?</summary>

Nee. De integratie is alleen-lezen. Dispel haalt inventaris en bevindingen op, maar maakt, wijzigt of verwijdert nooit gegevens in xDome.

</details>

<details>

<summary>Kan ik meer dan één xDome-tenant verbinden?</summary>

Ja. Claroty xDome ondersteunt meerdere integraties, dus je kunt meerdere tenants naast elkaar verbinden. Geef elke een unieke **weergavenaam** om ze uit elkaar te houden.

</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-nl/integreren-en-beheren/integrations/asset-discovery/claroty-xdome.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.