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

# Dragos

Verbind het Dragos Platform (SiteStore) om ontdekte OT-assets in Dispel binnen te halen, koppel Dragos-sensoren aan Wickets en houd apparaatgegevens en kwetsbaarheidsbevindingen synchroon.

## Overzicht

De Dragos-integratie stelt Dispel in staat de OT-assets op te halen die het Dragos-platform heeft ontdekt en deze als Dispel-apparaten te importeren. U maakt verbinding met uw Dragos **SiteStore** eenmalig, koppel elke Dragos-sensor aan een Dispel-facility en Wicket, en Dispel importeert de overeenkomende apparaten en houdt ze actueel via een terugkerende synchronisatie.

Dragos is een **assetdetectie** integratie. Dispel leest uit Dragos — het schrijft nooit terug naar het platform.

In Dragos, **sensoren** zijn de verzamelpunten die uw industriële netwerk bewaken. Dispel behandelt elke Dragos-sensor als een **site** die u koppelt aan een Dispel Wicket, zodat assets per sensor op de juiste plek terechtkomen.

#### Wat Dispel importeert

* Ontdekte assets (naam, IP-adres, MAC-adres, merk/model, besturingssysteem, apparaattype) als Dispel-apparaten.
* Waargenomen netwerkprotocollen en -poorten voor elk asset.
* Een link terug naar het asset in Dragos, opgeslagen op het apparaat.
* **Kwetsbaarheidsbevindingen** voor elk geïmporteerd apparaat — met zowel hardware-/firmware- als software-/OS-problemen — vernieuwd bij elke synchronisatie.

{% hint style="info" %}
**Waar u het vindt.** Meld u aan als organisatiebeheerder en open **Instellingen → Integraties**. Dragos verschijnt in de **Assetdetectie / netwerkzichtbaarheid** sectie. Klik op **Verbinden** op de Dragos-kaart om te beginnen.
{% endhint %}

## Voordat u begint

U heeft het volgende nodig uit uw Dragos SiteStore:

* Een **API-sleutel** — zijn **API-sleutel-ID** (de identificatie) en **API-sleutelgeheim**. Configureer dit in SiteStore.
* De **SiteStore-URL** van uw implementatie — bijvoorbeeld `https://customer.dragos.cloud`.

{% hint style="warning" %}
**Het API-sleutelgeheim wordt slechts één keer getoond.** Dragos toont het geheim slechts één keer wanneer u de sleutel configureert. Kopieer het dan — als u het verliest, configureer dan een nieuwe sleutel. Voeg ook Dispel's **Whitelist-IP** (weergegeven op het verbindingsformulier) toe aan uw firewall-allowlist zodat Dispel SiteStore kan bereiken, vooral voor on-premise implementaties.
{% endhint %}

## Dragos verbinden

1. Ga naar **Instellingen → Integraties** en klik **Verbinden** op de Dragos-kaart.
2. Stel optioneel een **Weergavenaam** om deze integratie van andere te onderscheiden (u kunt meer dan één SiteStore verbinden).
3. Vul de verbindingsvelden in:

| Veld                  | Type          | Opmerkingen                                                                               |
| --------------------- | ------------- | ----------------------------------------------------------------------------------------- |
| **SiteStore-URL**     | Configuratie  | De basis-URL van uw Dragos SiteStore-instantie.                                           |
| **API-sleutel-ID**    | Inloggegevens | De API-sleutel-id van uw Dragos SiteStore.                                                |
| **API-sleutelgeheim** | Inloggegevens | Het geheim dat aan de sleutel is gekoppeld. Versleuteld opgeslagen en nooit meer getoond. |

4. Klik op **Verbinding testen** om te bevestigen dat Dispel zich kan authenticeren bij SiteStore. Los eventuele gemelde fouten op voordat u opslaat.
5. Klik op **Opslaan**. Dispel slaat de integratie op en voert direct de eerste synchronisatie uit om uw sensoren te ontdekken.

{% hint style="info" %}
**Uw inloggegevens zijn versleuteld.** Het API-sleutelgeheim wordt versleuteld opgeslagen en wordt na het opslaan nooit meer weergegeven. Laat bij later bewerken de inloggegevensvelden leeg om de opgeslagen waarden te behouden.
{% endhint %}

## Sensoren koppelen aan Wickets

Zodra de eerste synchronisatie is voltooid, opent u de integratie om de **Sitekoppeling** sectie. Elke Dragos-sensor verschijnt als een site, en hier beslist u welke sensoren Dispel-apparaten worden en waar ze terechtkomen.

> Koppel elke vendorsite aan een Dispel-facility en wicket. Apparaten van gekoppelde sites worden gesynchroniseerd naar Dispel.

Voor elke sensor die u wilt importeren:

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 werkt elke gekoppelde sensor af — u ziet de voortgang per site verschuiven van wachten naar ophalen, naar synchroniseren, naar voltooid — en meldt daarna 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 assets en gewijzigde details automatisch worden opgepakt zonder dat jij 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 velden voor inloggegevens leeg om het huidige geheim te behouden.

## Kwetsbaarheidsbevindingen

Dragos rapporteert bekende kwetsbaarheden voor de assets die het bewaakt. Na elke geslaagde synchronisatie haalt Dispel de kwetsbaarheidsbevindingen op voor uw geïmporteerde apparaten — met zowel hardware-/firmware- als software-/OS-problemen — en koppelt deze aan die apparaten, zodat u de bekende problemen van een apparaat kunt zien zonder Dispel te verlaten. Bevindingen worden bij elke synchronisatie vernieuwd, en opgeloste bevindingen verdwijnen automatisch.

## 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 uitvoeren en sensoren ontdekken.                                    |
| **Gereed**                     | Verbonden en gesynchroniseerd; toewijzingen zijn 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 je opgeslagen toewijzingen.                                        |
| **Mislukt**                    | De laatste bewerking is mislukt — zie de foutaanwijzingen.                                   |

Een afzonderlijke **gezondheidsbadge** (Verbonden, Gedegradeerd, Onbereikbaar) geeft aan of Dispel momenteel de Dragos-API 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 API-sleutel-ID/-geheim werd geweigerd. De sleutel kan zijn vervangen, verlopen of ingetrokken — maak een nieuwe aan en werk de integratie bij. |
| **Eindpunt onbereikbaar** | Dispel kon SiteStore niet bereiken. Controleer de SiteStore-URL en of het IP-adres van Dispel op de allowlist van uw firewall staat.              |
| **Verbindings-time-out**  | SiteStore deed te lang over het reageren — vaak door netwerkvertraging of een firewallregel.                                                      |
| **Snelheidsbeperking**    | Dragos beperkte verzoeken. De volgende geplande synchronisatie zou moeten slagen.                                                                 |
| **Configuratiefout**      | De SiteStore-URL lijkt onjuist. Controleer de verbindingsinstellingen opnieuw.                                                                    |

## Veelgestelde vragen

<details>

<summary>Kan ik meer dan één Dragos SiteStore verbinden?</summary>

Ja. Dragos ondersteunt meerdere integraties, dus u kunt meerdere SiteStore-instanties naast elkaar verbinden. Geef elke een unieke **Weergavenaam** om ze van elkaar te onderscheiden.

</details>

<details>

<summary>Wat is een "site" voor Dragos?</summary>

Dispel koppelt Dragos **sensoren** aan sites. Elke sensor die uw netwerk bewaakt, verschijnt in de Site Mapping-lijst, zodat u assets van verschillende sensoren naar verschillende faciliteiten en Wickets kunt routeren.

</details>

<details>

<summary>Ik ben mijn API-sleutelgeheim kwijt. Wat moet ik doen?</summary>

Dragos toont het geheim slechts één keer tijdens het configureren. Als u het niet meer hebt, maak dan een nieuwe API-sleutel aan in SiteStore en werk de integratie bij met de nieuwe ID en het nieuwe geheim.

</details>

<details>

<summary>Verandert het verbinden met Dragos iets in SiteStore?</summary>

Nee. Dispel leest alleen uit Dragos. Het maakt, wijzigt of verwijdert nooit gegevens aan de Dragos-kant.

</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/dragos.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.