> 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/darktrace.md).
# Darktrace
Verbind Darktrace via de ActiveAI Security Portal API om ontdekte apparaten in Dispel binnen te halen — verrijkt met gedragsmatige Model Alerts en een directe link naar de Threat Visualizer — toegewezen aan een Wick
## Overzicht
De Darktrace-integratie laat Dispel de apparaten ophalen die Darktrace's zelflerende AI op uw netwerk heeft ontdekt en ze als Dispel-apparaten binnenbrengen, verrijkt met Darktrace's gedragsdetecties. U maakt één keer verbinding met uw Darktrace-instantie, koppelt die aan een Dispel-faciliteit en Wicket, en Dispel importeert de overeenkomende apparaten en houdt ze actueel via een terugkerende synchronisatie.
Darktrace is een cloudintegratie voor het ontdekken van assets. Dispel authenticeert zich bij het ActiveAI Security Portal en leest via Darktrace's cloud-API, en doet nooit iets anders dan lezen. U wijst Dispel naar uw Darktrace-master-URL; Dispel leidt uw instantienaam daarvan af en bereikt de API via Darktrace's cloudproxy.
Omdat een Darktrace-master één omgeving vertegenwoordigt, beschouwt Dispel die als één site die u toewijst aan één Wicket — er is geen sitespecifieke lijst die u moet doorlopen.
#### Wat Dispel importeert
* Apparaten die Darktrace heeft ontdekt, gematcht met uw bestaande Dispel-apparaten op basis van IP- en MAC-adres en geïmporteerd als nieuwe apparaten waar geen match is.
* Darktrace Model Alerts (zijn gedragsdetecties) als bevindingen op de overeenkomende apparaten, met ernst afgeleid van de categorie van het model.
* Een uitgebreide apparaatweergave: een ‘Enriched by Darktrace’-badge, een deep link naar het apparaat in de Darktrace Threat Visualizer, en een Darktrace-paneel met de status van Autonomous Response (Antigena), apparaatintelligentie, connectiviteit en een gedragsrisicoscore.
{% hint style="info" %}
**Waar u het vindt.** Meld u aan als organisatiebeheerder en open **Instellingen → Integraties**. Darktrace verschijnt in de **Asset Discovery / Netwerkzichtbaarheid** sectie. Klik op **Verbinden** op de Darktrace-kaart om te beginnen.
{% endhint %}
## Voordat u begint
U hebt het volgende van Darktrace nodig:
* Een Client Application die is gemaakt in het ActiveAI Security Portal, onder **Client-applicaties beheren**. Bij het aanmaken ervan krijgt u een **Client-ID** en een **Clientgeheim**.
* De **Darktrace-master-URL** van uw instantie — bijvoorbeeld `https://usw1-00000-01.cloud.darktrace.com`.
{% hint style="warning" %}
**Gebruik ActiveAI-clientapplicatiereferenties — niet de oude tokens.** De cloud van Darktrace vereist de OAuth2-referenties van de client-applicatie van het ActiveAI Security Portal. Het oudere Threat-Visualizer API-token/secretpaar zal niet authenticeren.
{% endhint %}
{% hint style="info" %}
**De Client Secret wordt één keer weergegeven.** Darktrace toont het secret alleen wanneer de Client Application wordt aangemaakt. Kopieer het dan; als u het kwijtraakt, maak dan een nieuwe Client Application aan.
{% endhint %}
## Darktrace verbinden
1. Ga naar **Instellingen → Integraties** en klik op **Verbinden** op de Darktrace-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 |
| ------------------------ | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Darktrace-master-URL** | Config | Uw Darktrace-master-URL, bijvoorbeeld `https://your-instance.cloud.darktrace.com`. Dispel leidt de instantienaam daarvan af. |
| **Client-ID** | Referentie | De Client ID van een Client Application die in het ActiveAI Security Portal is aangemaakt. |
| **Clientgeheim** | Referentie | De Client Secret die één keer wordt getoond wanneer de Client Application wordt aangemaakt. Versleuteld opgeslagen en daarna nooit meer weergegeven. |
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" %}
**Hoe de verbinding werkt.** Dispel wisselt uw Client ID en Client Secret in voor een kortlevend token bij de ActiveAI-autorisatieserver en roept de Darktrace-API aan via de `api.darktrace.com` cloudproxy, waarbij de instantie wordt afgeleid uit uw master-URL. Tokens worden automatisch vernieuwd.
{% endhint %}
{% hint style="info" %}
**Uw inloggegevens zijn versleuteld.** De Client Secret wordt bij opslag versleuteld en wordt na het opslaan nooit opnieuw weergegeven. Laat bij later bewerken de referentievelden leeg om de opgeslagen waarden te behouden.
{% endhint %}
## De instantie toewijzen aan een Wicket
Nadat de eerste synchronisatie is voltooid, opent u de integratie om de **Site-mapping** sectie. Darktrace verschijnt als één site die uw instantie 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 Darktrace in het toegewezen Wicket — u ziet de voortgang van wachtend, naar ophalen, naar synchroniseren, naar voltooid — en meldt daarna hoeveel apparaten zijn geïmporteerd. Geïmporteerde apparaten verschijnen in het toegewezen Wicket naast alle apparaten die u handmatig hebt toegevoegd, met hun Darktrace-verrijking en Model Alerts eraan gekoppeld.
## Uw inventaris actueel houden
* Dispel synchroniseert automatisch opnieuw volgens een terugkerend schema, zodat nieuw ontdekte apparaten, gewijzigde gegevens en nieuwe Model Alerts worden opgehaald zonder dat u iets hoeft te doen.
* Als u de nieuwste inventaris direct wilt ophalen, opent u de integratie en kiest u **Vernieuwen**.
* Als je verbindingsgegevens wilt wijzigen of inloggegevens wilt roteren, bewerk je de integratie en gebruik je **Opslaan en synchroniseren**. Laat de referentievelden leeg om de huidige Client Secret te behouden.
Model Alert-bevindingen worden bij elke synchronisatie vernieuwd, en waarschuwingen die Darktrace niet langer meldt, 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, Verminderd, Onbereikbaar) geeft aan of Dispel de Darktrace-API momenteel 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 kunt oplossen |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Authenticatie mislukt** | De Client ID of Client Secret werd afgewezen. Bevestig dat de Client Application actief is in het ActiveAI Security Portal en dat het secret actueel is — het wordt slechts één keer getoond, dus maak de applicatie opnieuw aan als het verloren is gegaan. |
| **Eindpunt onbereikbaar** | Dispel kon Darktrace niet bereiken. Controleer of de Darktrace Master URL correct is. |
| **Verbindingsfout door time-out** | Darktrace deed te lang over het reageren — meestal een tijdelijk netwerkprobleem; probeer het opnieuw. |
| **Configuratiefout** | De master-URL ziet er onjuist uit. Het moet uw Darktrace-cloud-master-URL zijn (bijvoorbeeld `https://your-instance.cloud.darktrace.com`); Dispel leidt de instantienaam daarvan af. |
## Veelgestelde vragen
Welke referenties gebruik ik — ActiveAI of de oude API-tokens?
Gebruik de client-applicatiereferenties van het ActiveAI Security Portal (een Client ID en Client Secret aangemaakt onder **Client-applicaties beheren**). De cloud van Darktrace vereist de OAuth2-clientcredentialsflow; het oudere Threat-Visualizer API-token/secretpaar zal niet authenticeren.
Wat is de "master-URL"?
Het is de URL van uw Darktrace-masterinstantie, bijvoorbeeld `https://usw1-00000-01.cloud.darktrace.com`. Dispel leidt uw instantienaam daarvan af en proxyt API-verzoeken via `api.darktrace.com`, dus u hoeft alleen de master-URL op te geven.
Welke bevindingen haalt Darktrace in Dispel binnen?
Darktrace's Model Alerts — zijn gedragsdetecties — gekoppeld aan de overeenkomende apparaten als bevindingen, met ernst afgeleid van de modelcategorie. Dit zijn gedragsdetecties, geen op CVE's gebaseerde kwetsbaarheden.
Triggert of wijzigt Dispel Autonomous Response (Antigena)?
Nee. De integratie is alleen-lezen. Dispel toont de status van Antigena als onderdeel van de apparaatrijking, maar triggert, wijzigt of wist nooit Autonomous Response-acties in Darktrace.
Kan ik meer dan één Darktrace-instantie verbinden?
Ja. Darktrace ondersteunt meerdere integraties, dus u kunt meerdere instanties naast elkaar verbinden. Geef elk een onderscheidende **weergavenaam** om ze uit elkaar te houden.
---
# 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/darktrace.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.